# Update iframe embeds for Video.js

player.mux.com is updating to Video.js and accepts a shorter list of parameters. Learn which parameters were renamed, deprecated, or removed, what changes in Mux Data, and how to keep Mux Player with player=mux-player.

player.mux.com, the iframe player that Mux hosts for every playback ID, is updating to [Video.js](/docs/guides/playback-videojs-with-mux) and accepts a shorter list of parameters. Most embeds keep working unchanged. This guide covers what changes and what, if anything, you need to do.

## What changes

* Every URL plays with Video.js. Add `player=mux-player` to keep an embed on [Mux Player](#keep-mux-player). We'll support `player=mux-player` for as long as Mux Player is in [maintenance mode](/docs/guides/player-faqs#what-does-maintenance-mode-mean-for-mux-player).
* Two parameters have new names: [`disable-mux-data` and `poster-time`](#renamed-parameters). The old names still work.
* `title`, `video-title`, `primary-color`, and the `autoplay` values `muted` and `any` are [deprecated](#deprecated-parameters). They still work.
* Rarely used Mux Player parameters are [removed](#removed-parameters). player.mux.com ignores them: the video still plays, without that setting. [Embed parameters](/docs/guides/player-mux-com-reference) lists every parameter that's still supported.
* Parameter names are case-sensitive and lowercase. `Autoplay=true` or `LOOP=true` is ignored. Write `autoplay=true` and `loop=true`. This applies to Mux Player embeds too.
* Mux Data reports a new [`player_software_name`](#mux-data).

## What you need to do

For most embeds, nothing. The URL, tokens, custom domains, start time, poster, `accent-color`, `autoplay`, `muted`, `loop`, `controls`, resolution limits (`max-resolution`, `min-resolution`), instant clips (`asset-start-time`, `asset-end-time`), `metadata-*`, [player.js](/docs/guides/player-mux-com#control-playback-from-your-page) control, and oEmbed work as before.

1. If an embed uses one of the [removed parameters](#removed-parameters), drop it, or add `player=mux-player` to keep the embed on [Mux Player](#keep-mux-player). We'll support `player=mux-player` for as long as Mux Player is in [maintenance mode](/docs/guides/player-faqs#what-does-maintenance-mode-mean-for-mux-player). If you need the parameter on Video.js, [contact Mux support](/support).
2. If a Mux Data dashboard, alert, or export filters on `player_software_name`, update the filter (see [Mux Data](#mux-data)).
3. If an embed writes a parameter name with capital letters, change it to lowercase.
4. When you next edit an embed, replace renamed and deprecated parameters with their new forms.

## Renamed parameters

The old names keep working as aliases. When a URL has both, the new name wins.

| Old name | New name | What it does |
| --- | --- | --- |
| `disable-tracking` | `disable-mux-data` | Turns off Mux Data monitoring for the embed. |
| `thumbnail-time` | `poster-time` | Time in seconds of the frame used for the default poster. |

## Deprecated parameters

These still work, but [Embed parameters](/docs/guides/player-mux-com-reference) lists them as deprecated. Use the replacement in new embeds.

| Parameter | Replacement |
| --- | --- |
| `title`, `video-title` | The asset's title from Mux. |
| `metadata-video-title` as the page title | The asset's title from Mux. `metadata-video-title` is still a Mux Data field. |
| `primary-color` | `accent-color`. Without `accent-color`, `primary-color` is used as the accent color. |
| `autoplay=muted` | `autoplay=true&muted=true` |
| `autoplay=any` | `autoplay=true`. Video.js treats `any` the same as `true`: if the browser blocks autoplay with sound, the video waits for the viewer to press play. |

Set an asset's title in the Mux dashboard, or with its `meta.title` field when you [create](/docs/api-reference/video/assets/create-asset) or [update](/docs/api-reference/video/assets/update-asset) the asset. The asset's title comes first, so `title` and `video-title` only apply to assets without one.

`metadata-video-title` still sets `video_title` in Mux Data. On an asset with no title, it also sets the page title. That second use is deprecated: set the asset's title instead.

## Removed parameters

The following infrequently-used parameters are removed.

If your embed needs one of these parameters, add `player=mux-player` to keep it on [Mux Player](#keep-mux-player). We'll support `player=mux-player` for as long as Mux Player is in [maintenance mode](/docs/guides/player-faqs#what-does-maintenance-mode-mean-for-mux-player). If you need the parameter on Video.js, [contact Mux support](/support).

| Parameter | What to do instead |
| --- | --- |
| `volume` | Set the volume from your page with [player.js](/docs/guides/player-mux-com#control-playback-from-your-page) `setVolume()`. |
| `storyboard-src` | None needed. Timeline previews come from the playback ID. For signed playback IDs, use `storyboard-token`. |
| `stream-type`, `default-stream-type` | None needed. player.mux.com reads the stream type from the stream before the page renders. |
| `prefer-playback` | None needed. player.mux.com chooses the playback engine for each stream. |
| `env-key` | None needed. Views report to the Mux Data environment of the playback ID. |
| `crossorigin` | None needed. Media requests are always `anonymous`. |

player.mux.com also now ignores `audio`, `backward-seek-offset`, `beacon-collection-domain`, `cap-rendition-to-player-size`, `cast-receiver`, `debug`, `default-duration`, `default-hidden-captions`, `default-show-remaining-time`, `disable-pseudo-ended`, `forward-seek-offset`, `fullscreen-element`, `hotkeys`, `initial-bandwidth-estimate-kbps`, `initial-estimate-segments`, `live-edge-offset`, `logo`, `max-auto-resolution`, `max-reconnect-retries`, `min-preload-segments`, `no-muted-pref`, `no-tooltips`, `no-volume-pref`, `nohotkeys`, `placeholder`, `playbackrate`, `playbackrates`, `prefer-cmcd`, `program-end-time`, `program-start-time`, `proudly-display-mux-badge`, `rendition-order`, `secondary-color`, `target-live-window`, `theme`, and `type`.

## Mux Data

Video.js embeds report a different `player_software_name`:

| Field | Before | Video.js | Mux Player (`player=mux-player`) |
| --- | --- | --- | --- |
| `player_software_name` | `mux-player-iframe` | `videojs-html-<engine>`, for example `videojs-html-hlsjs` | `mux-player-iframe` |
| `player_name` | Not set | `mux-player-iframe` | `mux-player-iframe` |
| `page_type` | Not set | `iframe`, or `watchpage` on the [watch page](/docs/guides/player-mux-com#watch-page) | `iframe`, or `watchpage` on the [watch page](/docs/guides/player-mux-com#watch-page) |

To find player.mux.com views, filter on `player_name` `mux-player-iframe`. Before the move to Video.js, player.mux.com didn't set `player_name`, so that filter alone misses every earlier view. To keep that history in a dashboard, alert, or export during the transition, match views where `player_name` is `mux-player-iframe` or `player_software_name` is `mux-player-iframe`.

`metadata-*` parameters still set Mux Data fields, such as `metadata-video-id` or `metadata-custom-1`. They can no longer override `player_software_name` or `player_software_version`.

## Keep Mux Player

```text
https://player.mux.com/{PLAYBACK_ID}?player=mux-player
```

With `player=mux-player`, the embed plays with Mux Player and reads every parameter it did before, including the removed ones. We'll support `player=mux-player` for as long as Mux Player is in maintenance mode. See the [FAQ](/docs/guides/player-faqs#what-does-maintenance-mode-mean-for-mux-player) for what maintenance mode means. If you depend on a removed parameter, [contact Mux support](/support) and tell us which one.

<GuideCard
  title="Embed videos with an iframe"
  description="Embed the player, set the common parameters, and control playback from your page."
  links={[
    {title: "Read the guide", href: "/docs/guides/player-mux-com"},
  ]}
/>

<GuideCard
  title="Embed parameters"
  description="See every parameter the iframe embed accepts, with its type, default, and an example."
  links={[
    {title: "Read the reference", href: "/docs/guides/player-mux-com-reference"},
  ]}
/>