---
title: Schema Deploy Errors
description: Understand schema compatibility errors reported by the Flexkit CLI and safely complete schema changes.
---

# Schema Deploy Errors

`flexkit deploy` compares your local schema with the deployed schema before applying an update. Compatibility checks prevent changes that could make existing data unreadable or unexpectedly remove fields used by Studio and GraphQL clients.

## Types of Changes

Schema changes fall into three groups:

- **Safe changes**, such as adding an entity or attribute, deploy normally.
- **Intentional breaking changes**, such as removing an entity or attribute, are blocked until you acknowledge them with `--allow-breaking-changes`.
- **Unsafe changes**, such as changing an existing attribute's `dataType`, cannot be overridden. Migrate the data through a new attribute instead.

The `--allow-breaking-changes` option only acknowledges entity and attribute removals. It does not bypass invalid schema configuration, generated SDL errors, or unsafe data type changes.

## Error Guides

- [Entity removed](./entity-removed)
- [Attribute removed](./attribute-removed)
- [Attribute data type changed](./attribute-data-type-changed)

Follow the guide linked by the CLI error before retrying the deployment.


---

[View full sitemap](/docs/sitemap.md)