> ## Documentation Index
> Fetch the complete documentation index at: https://tyk.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Video Embed

The `youtube-seo` shortcode allows you to easily embed YouTube videos in your documentation with proper styling and responsive behavior.

## When to Use

Use the `youtube-seo` shortcode whenever you need to embed a YouTube video in your documentation, such as:

* Product demonstrations
* Tutorial walkthroughs
* Conference presentations
* Webinar recordings
* Feature explanations

The shortcode ensures consistent styling and proper SEO attributes for all embedded videos across your documentation.

## Basic Usage

To embed a YouTube video, simply use the shortcode with the video ID:

```md theme={null}
{{</* youtube-seo id="VIDEO_ID" title="Video Title" */>}}
```

Replace `VIDEO_ID` with the actual YouTube video ID (the part after `v=` in a YouTube URL) and `Video Title` with a descriptive title for the video.

## Example

```md theme={null}
<iframe width="560" height="315" src="https://www.youtube.com/embed/J2BY7NYRk7U" title="Tyk API Gateway Overview" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
```

## Parameters

The shortcode supports several parameters:

| Parameter   | Required | Default                                                                                             | Description                                        |
| :---------- | :------- | :-------------------------------------------------------------------------------------------------- | :------------------------------------------------- |
| id          | Yes      | -                                                                                                   | The YouTube video ID                               |
| title       | Yes      | -                                                                                                   | The title of the video (for SEO and accessibility) |
| width       | No       | 640                                                                                                 | The width of the video in pixels                   |
| height      | No       | 360                                                                                                 | The height of the video in pixels                  |
| allow       | No       | accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share | Permissions for the embedded iframe                |
| frameborder | No       | 0                                                                                                   | Border around the iframe                           |

## Responsive Behavior

The embedded video will:

* Be centered on the page
* Maintain its aspect ratio on all screen sizes
* Have appropriate margin spacing above and below
* Appear at a comfortable size (640x360 by default)

## Advanced Usage

If you need to customize the video dimensions:

```md theme={null}
{{< youtube-seo id="VIDEO_ID" title="Video Title" width="800" height="450" >}}
```

If you need to restrict certain iframe permissions:

```md theme={null}
{{< youtube-seo id="VIDEO_ID" title="Video Title" allow="accelerometer; encrypted-media" >}}
```