Build with Sanity MCP in Replit. Prizes up for grabs! Submit by June 14 →

How to deploy Sanity v3 schemas so they appear in Vision tool and sanity.io/manage

23 repliesLast updated: Nov 29, 2025

Good afternoon! I currently have sanity studio (v3) setup in my next.js application. How do I go about deploying new schemas so I can use the vision tool properly? I added the schemas and they are showing in the desk view, but I can't query them correctly in the vision desk... I noticed that when I went back to "sanity.io/manage " the studio did not have my recent schema changes, yet the localhost:3000/studio/desk does. What do I need to do to add schemas properly? Thanks!
AI Update

I can see the issue you're running into! When you're running Sanity Studio embedded in your Next.js app (at localhost:3000/studio), you're essentially running a local development version of the Studio. This is different from any hosted/deployed Studio you might have at manage.sanity.io.

The key thing to understand: Your schemas are defined in your code (in your Next.js project), and they work locally because your local Studio reads them directly from your codebase. The Vision tool should work perfectly fine with just your local schemas for basic querying - you don't actually need to "deploy" schemas to query them in Vision.

If Vision isn't showing your documents correctly, here are the most common issues:

Regarding manage.sanity.io:

The Manage interface at manage.sanity.io is for project administration (managing team members, datasets, API tokens, etc.). It's separate from your Studio. If you're running an embedded Studio in Next.js, you typically won't see schema changes reflected at manage.sanity.io because that's not where your Studio is hosted.

When you DO need to deploy schemas:

Schema deployment via sanity schema deploy is only necessary if you're using newer AI features like Agent Actions, AI Assist, or Canvas. For basic Vision querying in your local embedded Studio, it's not required.

However, if you want a hosted version of your Studio at yourproject.sanity.studio (which would show up in manage.sanity.io), you'd run sanity deploy - this builds and deploys your entire Studio to Sanity's hosting, including your schemas.

Try this first: In your Vision tool, make sure you're on the right dataset and try a simple query like *[_type == "yourNewSchemaType"] - that should show you if documents of that type exist. The issue is almost always dataset selection rather than schema deployment!

Show original thread
23 replies

Was this answer helpful?

Sanity – Build the way you think, not the way your CMS thinks

Sanity is the developer-first content operating system that gives you complete control. Schema-as-code, GROQ queries, and real-time APIs mean no more workarounds or waiting for deployments. Free to start, scale as you grow.

Related contributions