®Sanity
Publish SEO articles into a Sanity dataset with schema-aware field mapping.
Quick links
Settings > Integrations > Sanity
Open the Sanity integration card in Superpractice.
Grow > SEO
Open SEO articles before publishing to Sanity.
Sanity Manage
Find project settings, datasets, and API token controls.
Sanity token docs
Review token creation and access details.
What the Sanity integration does
Sanity publishing writes Superpractice articles into a Sanity project and dataset. It supports common blog schemas and advanced mapping for custom schemas.
Setup
- Create a Sanity API token with dataset write access from Sanity Manage.
- Open Settings > Integrations > Sanity.
- Enter the project ID, dataset, API version, and token.
- Click
Connect Sanity. - Set the default author, blog base URL, and publish mode.
- If your schema differs from common blog defaults, open Advanced Schema Mapping.
- Map document type, author type, category type, and article fields.
- Save settings and publish a draft test article.
Schema mapping
| Field | Required | Notes |
|---|---|---|
| Document type | Yes | The Sanity type used for articles, commonly post. |
| Title field | Yes | Usually title. |
| Slug field | Yes | Usually slug. |
| Body field | Yes | Supports Portable Text, HTML, or Markdown depending on your schema. |
| Featured image field | No | Usually mainImage. |
| Author and categories | No | Map these if your content model uses references. |
Test publishing
- Set default publish mode to draft.
- Publish a test article from Superpractice SEO.
- Open Sanity Studio and confirm the document is created in the expected type.
- Confirm title, slug, excerpt, body, featured image, author, and categories.
- If any field is empty, update Advanced Schema Mapping and publish another draft.