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

# video

> Campo video — biblioteca de vídeos da loja, envio ou URL externa (experimental).

# `video`

| | |
| - | - |
| **type** | `video` ou `video_url` (equivalentes) |
| **Valor salvo** | `string` — UUID da biblioteca **ou** URL (YouTube, Vimeo, MP4) |
| **Estabilidade** | **Experimental** — não está em `STABLE_SETTING_TYPES` |

## Propriedades

| Prop | Obrigatório | Descrição |
| - | - | - |
| `id` | REQUIRED | Chave em `settings` |
| `type` | REQUIRED | `video` ou `video_url` |
| `label` | SHOULD | Label no Inspector |
| `default` | OPTIONAL | Valor inicial (geralmente `""`) |
| `info` | OPTIONAL | Texto de ajuda |

## Exemplo

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "heroVideo",
  "type": "video",
  "label": "Vídeo do hero",
  "info": "Biblioteca, upload ou URL do YouTube/Vimeo/MP4"
}
```

## Editor

Abre `VideoPickerModal` com três abas:

1. **Biblioteca** — vídeos existentes (thumbnail + status)
2. **Enviar** — envio para a biblioteca de vídeos da loja (MP4, MOV, WebM; máx. 200 MB)
3. **URL** — YouTube, Vimeo ou MP4/WebM externo

## Runtime

`CorvexVideo` não vem da plataforma. Crie `snippets/corvex-video/snippet.jsx` no tema. O hook público para UUID da biblioteca é `useCorvexVideoPlayback` em `@corvex/theme-sdk`. Implementação: [Padrões de vídeo](https://docs-loja.usecorvex.com.br/guides/video-patterns.md).

```jsx theme={"theme":{"light":"github-light","dark":"github-dark"}}
import CorvexVideo from '@corvex/snippets/corvex-video';

export default function MySection({ settings = {} }) {
  return (
    <CorvexVideo
      value={settings.heroVideo}
      poster={settings.heroPoster}
      autoplay
      muted
      loop
      controls={false}
    />
  );
}
```

**Nunca** passe o valor direto para `<video src={settings.heroVideo}>` sem classificar — UUID da biblioteca não é URL.

## Valores possíveis

| Padrão do valor | Origem | Renderização |
| - | - | - |
| UUID v4 | Biblioteca / Enviar | Resolver HLS ou poster |
| `https://youtube.com/…` | URL | `<iframe>` embed |
| `https://vimeo.com/…` | URL | `<iframe>` embed |
| `https://…/*.mp4` | URL | `<video src>` |

## Veja também

* [Hub — Biblioteca de vídeos](https://docs-loja.usecorvex.com.br/guides/video-library.md)
* [Schema — campo video](https://docs-loja.usecorvex.com.br/guides/video-schema.md)
* [Padrões](https://docs-loja.usecorvex.com.br/guides/video-patterns.md)
* [FAQ](https://docs-loja.usecorvex.com.br/guides/video-faq.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.