Back to docs

Workflow

Push to Contentful and Publish Safely

Understand the difference between push and publish, and how Inverb is intended to keep source fields safe.

1 min readUpdated Mar 21, 2026

Push and Publish are separate steps.

Push

Push sends the reviewed translation data from Inverb into Contentful.

Conceptually, push means:

  • the translation leaves Inverb
  • target-locale fields in Contentful are updated
  • nothing is live yet unless your Contentful setup makes draft changes visible somewhere else

Publish

Publish happens after push. It is the step that makes the Contentful changes live according to your Contentful environment and publishing mode.

Safety expectations

The intended model is simple:

  • source locale fields are authored by your team
  • target locale fields are where Inverb writes translations

If your source locale is English, English should remain the source of truth. Inverb should be used to populate non-source locales, not to rewrite the source fields.

Good release habit

For sensitive launches:

  1. translate
  2. review
  3. push
  4. inspect in Contentful
  5. publish

That gives you one extra inspection point before content goes live.

If publish is unavailable

Publish may stay disabled until:

  • the run has been pushed successfully
  • there are publishable changes
  • no other publish is currently in flight

If a publish fails, open the request details in Translations and inspect the error before retrying.