# Hide Video

## Description

```javascript
'hide video <video_id> [with <animation>]'
```

The `hide video` action stops and removes a video currently playing on the screen.

**Action ID**: `Hide::Video`

**Reversible**: Yes

**Requires User Interaction**: No

## Parameters

| Name      | Type     | Description                                                                         |
| --------- | -------- | ----------------------------------------------------------------------------------- |
| video\_id | `string` | The ID of the video to hide (same ID used in `show video`)                          |
| animation | `string` | Optional. Exit animation from [Animate.css](https://daneden.github.io/animate.css/) |

## Examples

### Basic Hide

Stop and remove a video immediately:

```javascript
'hide video rain'
```

### Hide with Animation

Remove a video with a fade out effect:

```javascript
'hide video news_broadcast with fadeOut'
```

### Complete Example

```javascript
monogatari.assets('videos', {
    'rain': 'rain_loop.webm',
    'tv_static': 'static.mp4'
});

monogatari.script({
    'Start': [
        // Show a looping background video
        'show video rain background with loop',
        'e The rain has been falling all day.',
        
        // Show another video
        'show video tv_static displayable',
        'e The TV signal is acting up again.',
        
        // Hide the TV video with animation
        'hide video tv_static with fadeOut',
        'e Finally, some peace and quiet.',
        
        // Hide the rain
        'hide video rain',
        'show scene sunny_day with fadeIn',
        'e Oh, the sun is coming out!',
        'end'
    ]
});
```

## Behavior

When hiding a video:

1. The video playback is stopped
2. Video resources are cleaned up to prevent memory leaks
3. If an animation is specified, it plays before removal
4. The element is removed from the DOM

### Animation Behavior

When using an animation:

* The video's `data-visibility` attribute is set to `invisible`
* The animation plays
* Once the animation ends, the video element is removed

## Error Handling

If the video ID doesn't match any currently playing video, the action completes silently without error.

## Related Actions

* [Show Video](/documentation/script-actions/show-video.md) - Display a video
* [Hide Image](/documentation/script-actions/hide-image.md) - Remove an image
* [Hide Character](/documentation/script-actions/hide-character.md) - Remove a character sprite


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.monogatari.io/documentation/script-actions/hide-video.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.