With uStudio's Asset Replacement feature the root media file can be updated without the need to change embed codes you've already used.
Sometimes, it may be necessary to change a video that has already been embedded on a page and is viewable in the wild. This can happen for any number of reasons, for instance, if there have been updates to the content in your video, you want to change out a product, a segment is no longer necessary, etc. With uStudio's Asset Replacement feature, you can swap out a video file and have the embedded player display the updated content without having to change any embed codes. Replacing the asset will not affect player configurations, video metadata, or stats associated with that video.
First, check if the "asset replacement" feature has been enabled on your studio. There are two ways to do this - either by going to the Edit Video screen for any video and looking for these icons underneath "Video Asset" in the right sidebar:
or by sending a GET request to the studio API and inspecting the returned configuration JSON for the following:
"feature_flags": [ "asset-replacement", ...
If you don't have this feature enabled, contact firstname.lastname@example.org to have it turned on for your studio.
To replace the asset, click the icon under "Video Asset" and select the video file you want to use in place of the existing one.
The new asset must be transcoded before the content is available. The amount of time it takes for transcoding to complete will depend on the size of the uploaded file. For a brief period of time after the replacement file has been uploaded, going to the embed code may return a "Video not yet available" message. The new content will be viewable as soon as the first transcode has completed, and embed codes using that video UID will play the new content.
- Replacing the asset will not change the video thumbnail. If the current thumbnail is no longer relevant, you can upload a new image or use the Thumbnail Selector to choose a still image from the new asset.
- YouTube and Facebook do not yet allow publishers to replace assets this way. If these channels are part of your distribution strategy, you would need to un-publish the video from those locations and send a separate new video there.