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

# Presets

> Gestiona configuraciones de render reutilizables

Un preset es una configuración de render reutilizable — fondo, estilo de subtítulos, diseño y otros ajustes visuales — que puedes aplicar a cualquier proyecto o exportación. Los presets son ideales cuando quieres mantener un aspecto consistente en muchas pistas.

Consulta [Render settings reference](/en/render-settings-reference) para ver la forma completa de `preset` y todas las opciones respaldadas por enums.

## `preset schema`

Devuelve el JSON Schema para la configuración de presets. Úsalo para descubrir los campos válidos antes de crear o actualizar un preset.

```bash theme={null}
youka preset schema --json
```

<Tip>
  Los agentes deben llamar a `preset schema` antes de modificar presets para conocer los
  nombres exactos de los campos y los tipos de valor.
</Tip>

## `preset list`

Lista todos los presets propiedad de la cuenta autenticada.

```bash theme={null}
youka preset list --json
```

## `preset show`

Obtiene un único preset por ID.

```bash theme={null}
youka preset show <presetId> --json
```

## `preset create`

Crea un nuevo preset.

```bash theme={null}
youka preset create [options]
```

### Options

| Option             | Description                                                     |
| ------------------ | --------------------------------------------------------------- |
| `--name <name>`    | Nombre del preset                                               |
| `--default`        | Marca el nuevo preset como el predeterminado                    |
| `--body <file\|->` | Lee el cuerpo completo de la solicitud desde un archivo o stdin |

<Note>
  El cuerpo de la solicitud debe contener el objeto `preset` completo. Para cargas grandes,
  prefiere `--body` en lugar de JSON inline.
</Note>

### Examples

<CodeGroup>
  ```bash from-file theme={null}
  youka preset create \
    --name "Neon Night" \
    --body ./neon-preset.json \
    --json
  ```

  ```bash make-default theme={null}
  youka preset create \
    --name "Red Cinema" \
    --body ./red-cinema.json \
    --default \
    --json
  ```

  ```bash from-stdin theme={null}
  cat ./preset.json | youka preset create --name "From stdin" --body - --json
  ```
</CodeGroup>

Las flags de la CLI sobrescriben los campos coincidentes de `--body`.

## `preset update`

Actualiza un preset existente.

```bash theme={null}
youka preset update <presetId> [options]
```

| Option             | Description                                           |
| ------------------ | ----------------------------------------------------- |
| `--name <name>`    | Nuevo nombre                                          |
| `--body <file\|->` | Cuerpo completo de la solicitud desde archivo o stdin |

Example:

```bash theme={null}
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json
```

## `preset delete`

Elimina un preset por ID.

```bash theme={null}
youka preset delete <presetId> --json
```

<Warning>
  Eliminar un preset no elimina proyectos ni exportaciones que se hayan
  renderizado previamente con él. Las exportaciones futuras que referencien el preset eliminado fallarán.
</Warning>

## `preset default`

Obtén o establece el preset predeterminado.

```bash theme={null}
youka preset default --json
youka preset default <presetId> --json
```

Sin argumentos, el comando devuelve el preset predeterminado actual o `null`. Con un ID de preset, marca ese preset como el predeterminado.

## Aplicar un preset

Aplica un preset a un proyecto o exportación con `--preset`:

<CodeGroup>
  ```bash on-create theme={null}
  youka project create ./song.mp3 --preset $PRESET_ID --wait
  ```

  ```bash on-settings-update theme={null}
  youka project settings $PROJECT_ID --preset $PRESET_ID
  ```

  ```bash on-export theme={null}
  youka export create $PROJECT_ID --preset $PRESET_ID --wait
  ```
</CodeGroup>

## Qué sigue

* [Render settings reference](/en/render-settings-reference) - todos los campos compartidos del preset
* [Projects](/es/cli/projects) - aplica presets a la configuración del proyecto
* [Exports](/es/cli/exports) - aplica presets al momento de renderizar
* [Media](/es/cli/media) - medios reutilizables referenciados por presets