Add video components to your CMS pages
Learn how to add videos to CMS detail pages in Framer and control their visibility dynamically using CMS variables and conditionals.
You can embed videos from YouTube, Vimeo, or your own hosting into CMS detail pages, or upload them directly to your CMS. You can also hide empty video spaces for items without a video.
Options for adding a video
You can add videos to a CMS detail page in several ways:
YouTube component
Vimeo component
Self-hosted video
Uploaded video
Adding a YouTube, Vimeo, or self-hosted video
This method lets you display videos hosted externally using a video URL.
Create a Video URL field in your CMS collection. Use the Plain Text field type.
Add video URLs to this field for each CMS item. Leave it blank for items without videos.
Insert a YouTube, Vimeo, or Video component on your CMS detail page. In the URL field, click the + button, select Set Variable, and choose Video URL from your CMS fields.

Uploading a video directly in the CMS
This method stores the video file in your CMS so it can be displayed without external hosting.
Add a File field to your CMS collection. This supports formats such as MP4.
Upload your video file to the CMS. Keep in mind that upload size limits apply.
Insert a Video component on your CMS detail page. Set the source to Upload, click the + button, choose Set Variable, and select File from your CMS fields.

Hiding empty fields
For items without a video, you can use conditionals to keep layouts clean.
In the Styles panel, go to Visible > Set Variable > Video URL/File > Is set.
This ensures the video space is only visible when a video file exists.
