YouTube Player

The YouTube Player widget embeds a YouTube video directly inside your app. It behaves like an inline YouTube player, allowing users to watch videos without leaving the screen or opening the YouTube app separately.

You can control basic playback behaviour such as autoplay, loop, and mute state.

Core Concepts

The YouTube Player widget is designed for:

• Embedding YouTube-hosted content inside your app UI.

• Avoiding context switching by keeping users inside the app.

• Reusing existing video content (tutorials, promos, explainers, ads, etc.) without uploading or encoding it again.

Internally, the widget:

1. Loads a YouTube video from the given videoUrl.

2. Renders the player inside a rectangular area (controlled via Layout properties).

3. Applies playback behaviour based on autoPlay, loop, and muted.

You get a YouTube experience, but inside your own screens and flows.

Properties

Property	Description
videoUrl	The URL of the YouTube video to play. This should be a valid YouTube link (e.g., https://www.youtube.com/watch?v=VIDEO_ID).
autoPlay	If true, the video will start playing automatically when the player loads.
loop	If true, the video will loop continuously and restart after it finishes.
muted	If true, the video will be muted by default when playback starts.

Performance Tip: Use muted = true with autoPlay = true when you want videos to start silently (common in modern UX patterns).

Default Properties

The YouTube Player widget supports all Default Properties.

Use Cases

The YouTube Player widget lets you play YouTube videos directly inside your app, without sending users out to the YouTube app or browser.

Use YouTube Player when you want to:

• Embed video content in your screens

  • Product demos, feature walkthroughs, app tutorials

  • Brand films, ads, testimonials, launch videos

• Educational or onboarding flows

  • How-to videos inside a help/FAQ section

  • Onboarding lessons, course content, or training modules

• Content & community

  • Show your YouTube channel content inside the app

  • Play livestreams, interviews, podcasts, or event recordings

• Marketing & engagement

  • Embed campaign videos on offers/promotions pages

  • Use video to increase trust (reviews, case studies, success stories)