# Schema Mismatches

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

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

## Video Tutorial

{% embed url="<https://www.youtube.com/embed/MLJzV8ASWm4?rel=0>" %}
How to fix Schema mismatches
{% endembed %}

## Step-by-step

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

![Schema Mismatch error message](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-93c6e0ec208eabb77d7c1cd07a2c4ae0c30ca41f%2Fschema-mismatch-on-transfer_v10.png?alt=media)

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

To resolve this error, check for pending deployments on the source environments. If you are working locally, push any changes that have not been committed through Git. If you are transferring between two Umbraco Cloud environments, you can see and deploy pending changes through the Umbraco Cloud Portal.

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 in the source environment (in the example above, it would be the **Contact Us** 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 involve differences in the `aliases` or `names`, changing these manually on the target environment will enable you to transfer your content.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/monitor-and-troubleshoot/resolve-issues-quickly-and-efficiently/deployments/schema-mismatches.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.