Joint session with Vercel: How to build intelligent storefronts (May 15th)

Installing Mux with Sanity v2 - compatibility issues

5 repliesLast updated: Nov 30, 2025

Has anyone successfully installed and using Mux in a project based on Sanity v2? I’ve tried to install it for over an hour now, and it won’t work..
AI Update

I can see you're struggling with installing the Mux plugin for Sanity v2. This is actually a known issue because Sanity v2 is now deprecated, and the plugin ecosystem has moved on to support Sanity Studio v3.

The good news is that there's still a working version for v2, but you need to install it specifically. Here's what you need to do:

For Sanity Studio v2

Install the Studio v2 version explicitly using the @studio-v2 tag:

yarn add sanity-plugin-mux-input@studio-v2

or with npm:

npm install sanity-plugin-mux-input@studio-v2

The Studio v2 README has specific instructions for the v2 version.

Common Installation Issues

If you're still having trouble, here are some things to check:

{
  title: 'Video',
  name: 'video',
  type: 'mux.video'
}

Consider Upgrading to Studio v3

Since you're having installation issues anyway, this might be a good time to consider upgrading to Sanity Studio v3. The current version of the plugin (sanity-plugin-mux-input) is actively maintained for v3, and you'll have much better support going forward. Studio v2 reached end-of-life, so you'll increasingly run into compatibility issues with newer tools and dependencies.

For Studio v3, the installation is simpler:

npm install sanity-plugin-mux-input

Then add it to your sanity.config.ts:

import {defineConfig} from 'sanity'
import {muxInput} from 'sanity-plugin-mux-input'

export default defineConfig({
  plugins: [muxInput()],
})

If you share more details about the specific error messages you're seeing during installation, I can help troubleshoot further!

Show original thread
5 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