Sanity troubleshooting

"Insufficient permissions" on publish

Your token doesn't have the Editor permission. Viewer tokens can't create documents or upload assets.

Fix: re-issue the token with the Editor permission at sanity.io/manage, then open the site page in Quibo, use Update credentials in the Credentials card, and the new values are verified against your CMS before they replace the old ones.

CORS error from the studio

Quibo talks to Sanity from its own servers, so it never triggers CORS. If your Studio shows a CORS error, add the Studio URL to the CORS allowed origins at sanity.io/manage, Project, API, CORS origins.

Documents land as post, or in the wrong type

Quibo picks the post type from the documents already in the dataset (post, article, blogPost, blog, news, story, entry, page, then the most common non-system type). An empty dataset gives it nothing to go on, so it falls back to post with the canonical fields (title, slug, language, metaTitle, metaDescription, coverImage, body, faq, schemaJsonLd, publishedAt, aiAssisted).

Fix: create one document of your real post type in Studio (a title and a body are enough), then click Re-crawl brand on the site page. The next publish uses the discovered type and field names.

Fields stay empty in Studio

Quibo only writes fields it has seen on your existing posts, matched by name (for example seoTitle or metaTitle, coverImage or mainImage, faq or faqs, schemaJsonLd or jsonLd). A field that no sampled post has ever filled, or that uses a name outside those aliases, is left alone.

Fix: fill the field on at least one existing post, click Re-crawl brand, then publish again. If the field name is unusual, email support with the name and we add the alias.

Default author dropdown is missing

The dropdown appears only when your post type has a reference field named author and at least one existing post references an author document.

Fix: set the author on one existing post in Studio, then click Re-crawl brand on the site page.

PortableText looks broken in studio

We render to a standard PortableText shape (block + span + marks + listItem, plus code blocks). If your body field only allows custom block types you need to register the standard block type in your schema. Sanity's PortableText docs cover this. Inline images from the article body are not sent, only the cover.

Cover image doesn't appear

The cover is uploaded as an image asset and referenced from the first image field named coverImage, cover, featuredImage, mainImage, heroImage, image or thumbnail. Sanity assets need a serializer in the front-end to render: make sure your front-end resolves asset._ref via @sanity/image-url.

Still stuck?

Email support@quibo.cc with the organization ID shown in Settings, Account. Business plans get priority routing, with a typical response under 8 business hours.

If you'd rather start clean: connecting a fresh test dataset for 5 minutes is faster than debugging your prod schema. Connect a new site