What does the version dropdown in Sanity Studio Vision tab represent?

The version dropdown in the Vision plugin controls which API version your GROQ queries are executed against. According to the Vision plugin documentation, it "allows you to query against different datasets within your project and select different API versions."

So yes, it's directly related to the API version like 2021-06-07 that you're using! The dropdown lets you select from versions like:

• v1 or vX (the original API version)
• v2021-03-25
• v2021-10-21
• v2021-06-07 (what you're using)
• And other date-based versions

Why this matters: Different API versions can have different GROQ query behaviors and features. For example, the v2021-03-25 release introduced full GROQ specification compliance, fixed the parent operator (^), and changed how three-valued logic works. The most recent v2025-02-19 changed the default perspective from raw to published.

Best practice: You should match the version selected in Vision with what your application code uses (in your Sanity client configuration's apiVersion parameter). This ensures that queries behave the same way when you test them in Vision as they will in your production app. If you're using 2021-06-07 in your code, select that same version in the Vision dropdown to get consistent results.

The dropdown is essentially letting you test your queries against the specific query engine version that will parse and execute them, which is why it's important to keep them aligned between Vision and your application.