# Video

Use this to add a video to your page.

## Appearance

[![image.png](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-11/scaled-1680-/JA0image.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-11/JA0image.png)

## Editing the Block

### Content

See here for more information about locating the Video IDs for Youtube and Vimeo.

<table border="1" id="bkmrk-field-purpose-headin" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50.0596%;"></col><col style="width: 50.0596%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Heading</td><td>*Enter a short block title - this will show above the main content of the block*</td></tr><tr><td>Video ID</td><td>*Enter the unique ID of the video you wish to add*  
</td></tr><tr><td>Video Type</td><td>Choose from:

- Youtube
- Vimeo

</td></tr></tbody></table>

### Settings

<table border="1" id="bkmrk-field-purpose-block-" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50.0596%;"></col><col style="width: 50.0596%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Block Width</td><td>*Choose from:*

- *25%*
- *33%*
- *50%*
- *66%*
- *75%*
- *100%*
- *Full Width (set to always be the full width of the user's device)*

</td></tr><tr><td>Visibility</td><td>*Set the block visibility from the list:*

- *Default (both)*
- *Desktop Only*
- *Mobile Only*
- *Hidden (none)*

</td></tr><tr><td>Heading Position</td><td>*Alter the alignment of the block header:*

- *Left*
- *Central*
- *Right*

</td></tr></tbody></table>

#### Additional Options

<table border="1" id="bkmrk-field-purpose-auto-p" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Auto-play?</td><td>*Toggle auto-play for the video (e.g. if the video automatically plays on page load)*</td></tr><tr><td>Loop?</td><td>*Toggle whether the video will or will not loop*</td></tr><tr><td>Hide controls?</td><td>*Hide player controls*</td></tr><tr><td>Allow header overlap?</td><td>*Toggles whether the video shows behind the header, as per Hero banners*

<p class="callout info">*Important: User must also 'hide page title' to enable this*</p>

</td></tr><tr><td>Portrait?</td><td>*Toggle if this is a Portrait video, e.g. a Youtube Short*</td></tr></tbody></table>

### Advanced

#### Padding

Adding padding will insert space within the current block; this will adjust the position of content within the block.

More information is available [here](https://bookstack.iconography.co.uk/books/general/page/padding).

#### Margin

The margin will add additional space around the current block.

More information is available [here](https://bookstack.iconography.co.uk/books/general/page/margin).