In this troubleshooting section, you can find help to resolve issues that you might run into when using Umbraco Deploy.

    If you are unable to find the issue you are having, then please reach out to our friendly support team at [email protected]

    Schema mismatches

    When transferring or restoring content between two Umbraco Deploy environments, you might run into Schema mismatch errors. These usually occur when the schema (this includes Document Types, Media Types, Data Types, Templates, Macros and Dictionary items) isn't in sync between the source environment and the target environment.

    In this guide you can learn how to resolve schema mismatch issues, and how you can avoid them in the future.


    When you run into schema mismatch errors, they will usually look something like this:

    Schema Mismatch error message

    In this error message, you are able to see exactly which schema mismatch(es) is preventing the content transfer / restore.

    First step in resolving this error is to check for pending deployments on the source environments. If you are working locally, check for and push any uncommitted changes through Git. Are you transferring between two Umbraco Deploy environments, you need to deploy the changes to the next environment first.

    If there are no pending deployments in your source environment, there are two ways to go about resolving the schema mismatch:

    1. Make a minor change to the schema with mismatches on the source environment (in the example above it would be the Homepage Document Type).
    2. Deploy the change to the next environment
      • This will update your schema in the target environment and ensure it is in sync with the source environment

    If the mismatches involves differences to aliases or names, changing these manually on the target environment will enable you to transfer your content.