For dashboard-based migrations, see Migrating Content.
Automated syncing with Write API
When to use Write API vs Migrations:
- Migrations tool: Best for one-time or infrequent bulk content transfers between environments. Handled by the ButterCMS support team through the dashboard.
- Write API: Best for automated, programmatic, or frequent content syncing. Requires development work but gives you full control over what, when, and how content is synced.
Basic sync script
Syncing localized collections
Collection reads return one locale per request, while the Write API accepts every locale in a single item. Fetch each locale from the source, group the results bymeta.id and nest the fields under their locale codes. Both sites must have the same locale codes configured.
Scheduled sync
Set up automated syncing with cron jobs or serverless functions:Write API access is a paid add-on for Advanced and Professional plans. Enable it from the Billing page in your dashboard.