AddThisFeature

Contentful Entry Sync

Create and update Contentful entries against the connected space, environment, and locale.

involved Integrations

What it adds

A sync that writes app records into Contentful entries using the connected space's content model and locale configuration.

What your agent is told to do

5
  1. 1

    Have the operator select the space, the environment, and the default locale during connection, and store all three, because writing production content into a sandbox environment is an easy and expensive mistake.

  2. 2

    Fetch the content model at connection time and again before each sync run, map app fields to entry fields by their stable identifiers, and validate the value type against the model before attempting the write.

  3. 3

    Write every localized field under an explicit locale rather than relying on whatever the space treats as default, and state clearly which locales the app owns and which it leaves to editors.

  4. 4

    Resolve and confirm every referenced entry and asset before writing the entry that points at them, and hold the write if a target does not exist rather than creating an entry with dangling references.

  5. 5

    Do not blindly overwrite a published entry that has been changed by an editor since the app last wrote it. Compare against the version the app last saw and, on divergence, stop and report the conflict rather than discarding a person's work.

Edge cases it handles

8
  • Fields must be addressed by their stable identifiers, and the value type must be checked against the model first. A string sent into a field the model now defines as a reference fails after the request has already partially applied.
  • Localized fields fall back between locales in ways that hide missing content. Writing only the default locale can leave other locales displaying stale text that looks current.
  • References and assets must exist and be processed before the entry referencing them is written, and asset processing is asynchronous, so a link created immediately after upload can point at something not yet usable.
  • An entry can be draft, published with no changes, published with unpublished changes, or archived. The app must decide which of these it may transition and must not resurrect an archived entry as a side effect of a routine sync.
  • Editorial changes must not be silently clobbered. Detect that the entry moved on since the app last wrote it, and surface the conflict to a human rather than resolving it by overwriting.
  • Rate limits apply per space and are easy to hit during an initial backfill. Batch, back off with jitter, and make a long backfill resumable so a limit part way through does not require starting over.
  • The management credential expires or is revoked. Detect authentication failure distinctly from other errors, mark the connection as needing reconnection, and surface it in the app instead of failing quietly in a background job.
  • When the destination is unavailable, the app's own content must remain saved and usable, with the sync marked as pending rather than the user's save being rejected.

Definition of done

9
  • Space, environment, and locale are chosen explicitly at connection and stored.
  • Field mappings use stable identifiers and are type-checked against the fetched content model before writing.
  • Localized fields are written under an explicit locale, with the app's ownership of each locale stated.
  • References and assets are confirmed to exist and be processed before the referencing entry is written.
  • An entry changed by an editor since the last sync raises a conflict instead of being overwritten.
  • Entry states including archived are handled explicitly, with no unintended state transitions.
  • Rate limits and expired credentials surface as recoverable, operator-visible conditions.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.