> ## 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.

# base44 entities push

> Push local entity definitions to Base44.

<Warning>
  This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the [developer documentation](/developers).
</Warning>

# base44 entities push

Push local entity definitions to Base44.

## Syntax

```bash theme={null}
npx base44 entities push [options]
```

## Options

| Option      | Description              | Required |
| ----------- | ------------------------ | -------- |
| `-y, --yes` | Skip confirmation prompt | No       |

## Authentication

**Required**: Yes. If not authenticated, you'll be prompted to login first.

## What It Does

1. Pushes all entities that exist in the `base44/entities` folder
2. Validates that entities exist in the folder
3. Displays the count of entities to be pushed
4. Asks for confirmation before overwriting remote entities (unless `-y`/`--yes` is passed)
5. Uploads entities to the Base44 backend
6. Reports the results: created, updated, and deleted entities

## Prerequisites

* Must be run from a Base44 project directory
* Project must have entity definitions in the `base44/entities` folder

## Confirmation Prompt

This push overwrites your app's entities with your local copy and deletes any not present locally. Before pushing, the CLI warns you and asks for confirmation:

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

Found 3 entities to push: User, Post, Comment
⚠ This will overwrite your app's entities with your local copy and delete any not present locally.
? Are you sure you want to continue? › Yes
```

In non-interactive mode (`--json`, CI/CD, no TTY), you must pass `-y`/`--yes` or the command throws.

## Output

```bash theme={null}
$ npx base44 entities push --yes

Found 3 entities to push
Pushing entities to Base44...

Created: User, Post
Updated: Comment
Deleted: OldEntity

✓ Entities pushed successfully
```

## Entity Synchronization

The push operation synchronizes your local entity schema with Base44:

* **Created**: New entities that didn't exist in Base44
* **Updated**: Existing entities with modified schema or configuration
* **Deleted**: Entities that were removed from your local configuration

## Error Handling

If no entities are found in your project:

```bash theme={null}
$ npx base44 entities push
No entities found in project
```

## Use Cases

* After defining new entities in your project
* When modifying existing entity schemas
* To sync entity changes before deploying
* As part of your development workflow when data models change

## Notes

* This command syncs the entity schema/structure, not the actual data
* Changes are applied to your Base44 project immediately
* Make sure to test entity changes in a development environment first
* Entity definitions are located in the `base44/entities/` directory