Mux static MP4: highest or explicit resolutions, no upscaling, mp4_support deprecated

TL;DR

Enable staticrenditions with highest for the top quality up to 4K, or pick specific resolutions like 1080p and 720p, plus audio-only for an M4A download. To let users download Mux videos, enable staticrenditions with highest or an explicit resolution list; do not mix the two modes.

Steps

1. To let users download Mux videos, enable staticrenditions with highest or an explicit resolution list; do not mix the two modes. Expect renditions above the source resolution to be skipped, and use staticrenditions rather than the deprecated mp4_support field.

When to use

You are seeing this: You cannot mix highest with specific resolutions. Use this skill when you run into "Mux static MP4: highest or explicit resolutions, no upscaling, mp4_support deprecated".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Official Mux docs (static MP4 renditions): documents how to make videos downloadable. Enable staticrenditions with highest for the top quality up to 4K, or pick specific resolutions like 1080p and 720p, plus audio-only for an M4A download. You cannot mix highest with specific resolutions. Mux never upscales, so renditions above the source resolution are skipped automatically. The older mp4support field is deprecated in favor of static_renditions.

Verified resolution: To let users download Mux videos, enable staticrenditions with highest or an explicit resolution list; do not mix the two modes. Expect renditions above the source resolution to be skipped, and use staticrenditions rather than the deprecated mp4_support field.

Source URL: https://docs.mux.com/guides/video/enable-static-mp4-renditions