> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# entities push

> Push local entity schemas to Base44

Synchronize your local [entity schema definitions](https://docs.base44.com/developers/backend/resources/entities/overview.md) with your Base44 project. The command reads all `.json` and `.jsonc` files in your entities directory, validates them, and pushes them to Base44. By default the entities directory is `base44/entities/`, but you can customize the path in your [project configuration](https://docs.base44.com/developers/backend/overview/project-structure.md#config-jsonc).

## Usage

```bash theme={null}
base44 entities push
```

## Flags

| Flag | Description |
| - | - |
| `-y, --yes` | Skip the confirmation prompt. |

## Sync behavior

The command performs a full sync operation. For each entity, the action taken is determined by its state locally and remotely:

| Local state | Remote state | Result |
| - | - | - |
| Entity exists | Entity exists | Remote schema is replaced. |
| Entity exists | Entity missing | New entity is created. |
| Entity missing | Entity exists | Remote entity is removed. See the warning below. |

> [!WARNING]
>
> Deleting an entity removes its schema from Base44. Existing data in that
> entity is not automatically deleted, but the entity will no longer be
> accessible through the SDK.

## See also

* [Project Structure](https://docs.base44.com/developers/backend/overview/project-structure.md): How entity schemas fit into your project
* [Quickstart - Backend only](https://docs.base44.com/developers/backend/quickstart/templates/quickstart-backend-only.md): Create your first backend-only project
* [Quickstart - React](https://docs.base44.com/developers/backend/quickstart/templates/quickstart-react-template.md): Build a full-stack React app with Base44


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.