---
title: Video Blocks
description: Add a video block to a lesson in Passion Studio.
---

[Skip to content](https://help.passion.io/hc/en-us/articles/4408251773969-how-to-add-video-widgets#main-content)

<https://help.passion.io/hc/en-us/kb-tickets/new?hsLang=en>

[![Full Passion.io logo (white)](https://help.passion.io/hs-fs/hubfs/Full%20Passion.io%20logo%20(white).png?width=185&height=50&name=Full%20Passion.io%20logo%20(white).png)](https://passion.io/)

Open main navigation

Close main navigation

- <https://help.passion.io/hc/en-us/kb-tickets/new>
- [Contact us](https://help.passion.io/hc/en-us/kb-tickets/new)

[Contact us](https://help.passion.io/hc/en-us/kb-tickets/new?hsLang=en)

 👋 How can we help you today?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.passion.io/hc/en-us?hsLang=en)
2. [Create & Customize your App](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en)
3. [🧱 Lesson Widgets](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#lesson-widgets)

September 8, 2026

# Video Blocks

## Add a video block to a lesson in Passion Studio.

### **In This Article**

> #### **[Upload a Video Directly](https://help.passion.io/hc/en-us/articles/4408251773969-how-to-add-video-widgets#T1)**
> 
> #### [Add YouTube or Vimeo Videos](https://help.passion.io/hc/en-us/articles/4408251773969-how-to-add-video-widgets#T2)
> 
> #### **[Troubleshooting](https://help.passion.io/hc/en-us/articles/4408251773969-how-to-add-video-widgets#T3)**

### **Upload a Video Directly**

**Uploading videos directly ensures the best experience for your audience with custom thumbnails, offline viewing, and playback control.**

#### **Before uploading, consider the following:**

- The video file size depends on your Passion plan. Please check our [pricing page](https://passion.io/pricing) for more information.
- Uploaded video file types need to be in a .mov or .mp4 format.
- In native apps, videos display in a player that has a 16:9 aspect ratio, so black bars will display on videos with other aspect ratios.

#### **To upload a video:**

1. Go to **Content** and open the lesson.
2. On an empty line, press `/` (or click the **+**) to open the block picker and search **“Video”**.
3. Upload an **MP4** or **MOV** file.

#### **Add a custom thumbnail:**

After uploading a video directly to your Passion app, you can add a custom thumbnail.

The thumbnail needs to follow the following format:

- Maximum upload size: 5MB
- File type: .jpeg or .png

To add a thumbnail:

1. Tap on **the three dots** while hovering over the video \> click on **Edit**.
2. Tap the **trash can icon** over the current thumbnail.
3. Click on **Upload thumbnail** and select the thumbnail file from your device.
4. Click on **Add video.**

### **Add YouTube or Vimeo videos**

**Add videos hosted on YouTube or Vimeo to the video widget by using your video's URL.**

#### Before linking, check your video privacy permissions:

- [YouTube](https://support.google.com/youtube/answer/157177?hl=en&co=GENIE.Platform%3DDesktop): The video must be set to **Unlisted** (not Private).
- [Vimeo](https://help.vimeo.com/hc/en-us/articles/12426199699985-About-video-privacy-settings): The video must be set to **Unlisted** or **Hide from Vimeo**.

#### To upload a third-party video:

1. Go to **Content** and open the lesson.
2. On an empty line, press `/` (or click the **+**) to open the block picker and search **“Video”**.
3. Under video link, paste the video link.

With YouTube or Vimeo links, offline sync and playback in the native app are disabled.

### **Troubleshooting**

To troubleshoot issues with video widgets, visit:

- [Play and Share Videos without Issues](https://help.passion.io/hc/en-us/articles/360020156198-how-to-troubleshoot-video-issues-in-the-app?hsLang=en)
- [Troubleshoot Video Uploads](https://help.passion.io/hc/en-us/articles/360010797897-how-to-troubleshoot-video-uploads?hsLang=en)<https://help.passion.io/hc/en-us/articles/360020156198-how-to-troubleshoot-video-issues-in-the-app?hsLang=en>

- [Getting Started](https://help.passion.io/hc/en-us/getting-started?hsLang=en#main-content)

    - [🎬 Start Here](https://help.passion.io/hc/en-us/getting-started?hsLang=en#start-here)
    - [⚙️ App Basics](https://help.passion.io/hc/en-us/getting-started?hsLang=en#%EF%B8%8F-app-basics)
    - [🙌 PassionFighters Community](https://help.passion.io/hc/en-us/getting-started?hsLang=en#passionfighters-community)
    - [❓ FAQs](https://help.passion.io/hc/en-us/getting-started?hsLang=en#faqs)
- [Create & Customize your App](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#main-content)

    - [🎨 Design & Branding](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#design-branding)
    - [📚 Product Structure](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#product-structure)
    - [📖 Building Content](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#building-content)
    - [🧱 Lesson Widgets](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#lesson-widgets)
    - [✨ AI Features](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#ai-features)
    - [👤 User Onboarding](https://help.passion.io/hc/en-us/create-customize-your-app?hsLang=en#user-onboarding)
- [Manage & Engage Your Users](https://help.passion.io/hc/en-us/manage-engage-your-users?hsLang=en#main-content)

    - [📱 User Management](https://help.passion.io/hc/en-us/manage-engage-your-users?hsLang=en#user-management)
    - [👥 Community Building](https://help.passion.io/hc/en-us/manage-engage-your-users?hsLang=en#community-building)
    - [📺 Live Content & Streaming](https://help.passion.io/hc/en-us/manage-engage-your-users?hsLang=en#live-content-streaming)
    - [🔔 Engagement & Notifications](https://help.passion.io/hc/en-us/manage-engage-your-users?hsLang=en#engagement-notifications)
    - [📊 User Analytics & Progress](https://help.passion.io/hc/en-us/manage-engage-your-users?hsLang=en#user-analytics-progress)
- [Grow Your Business](https://help.passion.io/hc/en-us/grow-your-business?hsLang=en#main-content)

    - [💰 Revenue Management](https://help.passion.io/hc/en-us/grow-your-business?hsLang=en#revenue-management)
    - [⚡ Zapier Automations](https://help.passion.io/hc/en-us/grow-your-business?hsLang=en#zapier-automations)
    - [🔌 Integrations](https://help.passion.io/hc/en-us/grow-your-business?hsLang=en#integrations)
    - [📈 Marketing & Acquisition](https://help.passion.io/hc/en-us/grow-your-business?hsLang=en#marketing-acquisition)
- [App Store Listing](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#main-content)

    - [⚙️ Start Here](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#%EF%B8%8F-start-here)
    - [🍎 Apple App Store](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#apple-app-store)
    - [🤖 Google Play Store](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#google-play-store)
    - [🔧 Developer Account Setup](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#developer-account-setup)
    - [Google Developer Account Setup](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#google-developer-account-setup)
    - [💰 Monetization & Pricing](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#monetization-pricing)
    - [📋 Platform Policies](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#platform-policies)
    - [🔍 App Store Visibility](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#app-store-visibility)
    - [❓ Troubleshooting](https://help.passion.io/hc/en-us/app-store-listing?hsLang=en#troubleshooting)
- [Troubleshooting](https://help.passion.io/hc/en-us/troubleshooting?hsLang=en#main-content)

    - [🖥️ Technical Issues](https://help.passion.io/hc/en-us/troubleshooting?hsLang=en#%EF%B8%8F-technical-issues)
    - [🎬 Media & Content Troubleshooting](https://help.passion.io/hc/en-us/troubleshooting?hsLang=en#media-content-troubleshooting)
    - [💬 Other](https://help.passion.io/hc/en-us/troubleshooting?hsLang=en#other)
- [Product Updates](https://help.passion.io/hc/en-us/product-updates?hsLang=en#main-content)

    - [💫 Improvements](https://help.passion.io/hc/en-us/product-updates?hsLang=en#improvements)
    - [⭐ New](https://help.passion.io/hc/en-us/product-updates?hsLang=en#new)
- [Account & Subscription Management](https://help.passion.io/hc/en-us/account-subscription-management?hsLang=en#main-content)

    - [👤 Account Management](https://help.passion.io/hc/en-us/account-subscription-management?hsLang=en#account-management)
    - [🔄 Subscription Management](https://help.passion.io/hc/en-us/account-subscription-management?hsLang=en#subscription-management)
    - [🤝 Referral Programs](https://help.passion.io/hc/en-us/account-subscription-management?hsLang=en#referral-programs)
- [Passion Funnels](https://help.passion.io/hc/en-us/passion-funnels?hsLang=en)
- [Your Users Experience](https://help.passion.io/hc/en-us/your-users-experience?hsLang=en)

[![Passion.io logo with pink rounded square icon containing white 'P' and black text reading 'Passion.io'](https://help.passion.io/hs-fs/hubfs/Passion.io%20in%20rounded%20rectangle.png?width=286&height=100&name=Passion.io%20in%20rounded%20rectangle.png "Passion.io logo with pink rounded square icon containing white 'P' and black text reading 'Passion.io'")](https://passion.io/)

<https://www.facebook.com/groups/2035741163136080> <https://twitter.com/i/flow/login?redirect_after_login=%2Fpassion_io> <https://www.instagram.com/passion_io/?hl=en> <https://podcasts.apple.com/us/podcast/million-dollar-creators/id1716703170> [mailto:instructor@passion.io](mailto:instructor@passion.io) <https://www.linkedin.com/company/passion.io/>

Copyright © 2026, Passion.io | A service powered by Independence284, Inc.