Prismic integration
No native Prismic connector, here is what does work.
We stage complete, validated drafts into a Prismic Migration Release for your one-click publish.
How it works
Prismic's Migration API, generally available on all plans, is the supported way to write documents programmatically. We authenticate with a bearer token plus an API key and write your content as documents in Prismic's structured rich text format, converted and validated before anything is sent. Everything we write lands as drafts inside a Migration Release in your repository.
Prismic does not allow programmatic publishing, and that is by design as a security measure, not a gap we can code around. A human in your Prismic workspace must click publish. So we do everything up to that click: complete documents, correct rich text, metadata in place, grouped in one release, with a notification and a direct link when a batch is ready. We never claim auto-publish on Prismic, because it does not exist.
Best forTeams on Prismic who want finished, validated content batches that only need one editorial click to go live.
Setup, step by step
- Generate a Migration API access token in your Prismic repository settings.
- Add the token and your repository name to SearchHandled's Prismic connector.
- Map your Prismic custom types and fields to our content structure during setup.
- Run a test staging, which places a sample draft in a Migration Release for you to inspect.
- Pick who gets notified when a release is staged and ready to publish.
Best practices
Publish releases as batches
The Migration Release groups our drafts together, so review them as a set and publish in one action rather than hunting through individual documents. It keeps your editorial pass short.
Keep custom types stable
Our field mapping is built against your custom types at setup. If you restructure a type in Prismic, tell us or reconnect the mapping so staged documents keep matching your schema.
Treat the publish click as your approval gate
Since Prismic requires a human publish anyway, use it as your quality gate. Skim the staged release, publish what is ready, and flag anything back to us instead of editing in place.
Let rich text stay structured
We convert content into Prismic's structured rich text rather than pasting HTML into a single field. That keeps your slices and front-end rendering working exactly as your developers built them.
Known issues
What practitioners actually report, from official docs, issue trackers, and community forums.
No programmatic publishing, by design
The Migration API writes drafts into a Migration Release only. Prismic requires a human to click publish as a deliberate security measure.
How we handle itWe stage complete, validated releases and notify the owner with a one-click path to publish. We do not claim auto-publish on Prismic, because no tool can honestly offer it.
prismic.io
Rich text must match Prismic's structured format
Content written as plain HTML or loose markup will not render correctly through Prismic's slices and serializers.
How we handle itWe convert every document into Prismic's structured rich text format and validate it against your custom types before staging, so what lands in the release renders correctly.
prismic.io
Field mapping depends on your custom types
Every Prismic repository defines its own custom types, so a generic payload will not fit yours.
How we handle itWe map to your specific custom types and fields during setup and re-validate the mapping whenever a staging error suggests the schema changed.
prismic.io
Questions teams ask
- Can SearchHandled publish automatically to Prismic?
No, and neither can anyone else. Prismic requires a human to click publish as a security measure. We stage everything into a Migration Release so that click is the only step left.
- Which Prismic plans support this?
The Migration API is generally available on all Prismic plans, so no plan upgrade is needed. You just need a repository and a Migration API token.
- What does a staged release look like on my side?
A Migration Release in your repository containing our drafts, each a complete document with structured rich text and metadata. You review the batch and publish it in one action.
Not connectable yet
Start with the plan, not the connector.
Build a Growth Map from your site to see the work itself. Approved pages can leave through the export or the webhook today, and telling us Prismic matters moves it up the rollout.