Migrate from Sanity
There is no Sanity importer. Export documents (GROQ or a dataset export), then write Objects.
await cosmic.objects.insertOne({
title: doc.title,
type: 'posts',
slug: doc.slug?.current,
metadata: {
content: markdownFromPortableText(doc.body),
},
});
markdownFromPortableText is your converter. Cosmic rich text is markdown with optional block shortcodes, documented in Rich text.
Image assets upload through Media. Create referenced documents before the documents that point at them.
FAQ
Does Cosmic store Portable Text?
Not as a native field. Convert Portable Text to markdown for a rich-text metafield, or store the JSON in a text metafield and render it yourself.
How do documents map?
A Sanity document type becomes an Object type. Documents become Objects. Sanity images become Cosmic media, then a media metafield stores the uploaded file.
How much does Cosmic cost?
Project plans are Free ($0), Builder ($99/mo), Team ($299/mo), Business ($499/mo), Enterprise (custom pricing). Yearly billing saves 10%. Workspace plans are Small Workspace ($999/mo) and Large Workspace ($2,999/mo), and they start with a 30-day free trial. Allowances, add-on rates, and the rest of the pricing FAQ are plain text at https://www.cosmicjs.com/pricing.md.
Are API keys required, and is content private?
Each Bucket has a read key and a write key in Bucket Settings > API Access. GET requests use the read key. POST, PATCH, and DELETE use the write key as Authorization: Bearer. Do not put the write key in a browser bundle, a mobile app, or a NEXT_PUBLIC_ variable. SAML single sign-on is on Large Workspace and Enterprise. The audit log is append-only. Text versions: https://www.cosmicjs.com/security.md and https://www.cosmicjs.com/docs/dashboard/audit-log.md.
Can an agent create a Cosmic project without an existing account?
Yes. POST https://dapi.cosmicjs.com/v3/agents/sign-up provisions a free-tier project and bucket tied to a human email, with no existing Cosmic account. The human claims it with the emailed one-time code. The playbook is https://www.cosmicjs.com/docs/ai-onboarding.md.