Presets

A preset is a reusable render configuration — background, subtitle style, layout, and other visual settings — that you can apply to any project or export. Presets are ideal when you have a consistent look across many tracks. See Render settings reference for the full preset shape and every enum-backed option.

`preset schema`

Return the JSON Schema for preset settings. Use this to discover valid fields before creating or updating a preset.

youka preset schema --json

Agents should call preset schema before mutating presets so they know the exact field names and value types.

`preset list`

List all presets owned by the authenticated account.

youka preset list --json

`preset show`

Fetch a single preset by ID.

youka preset show <presetId> --json

`preset create`

Create a new preset.

youka preset create [options]

Options

Option	Description
`--name <name>`	Preset name
`--default`	Mark the new preset as the default
`--body <file\|->`	Read the full request body from a file or stdin

The request body should contain the full preset object. For large payloads, prefer --body instead of inline JSON.

Examples

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json

youka preset create \
  --name "Red Cinema" \
  --body ./red-cinema.json \
  --default \
  --json

cat ./preset.json | youka preset create --name "From stdin" --body - --json

CLI flags override matching fields from --body.

`preset update`

Update an existing preset.

youka preset update <presetId> [options]

Option	Description
`--name <name>`	New name
`--body <file\|->`	Full request body from file or stdin

Example:

youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

`preset delete`

Delete a preset by ID.

youka preset delete <presetId> --json

Deleting a preset does not delete projects or exports that were previously rendered with it. Future exports that reference the deleted preset will fail.

`preset default`

Get or set the default preset.

youka preset default --json
youka preset default <presetId> --json

With no argument, the command returns the current default preset or null. With a preset ID, it marks that preset as the default.

Applying a preset

Apply a preset to a project or export with --preset:

youka project create ./song.mp3 --preset $PRESET_ID --wait

youka project settings $PROJECT_ID --preset $PRESET_ID

youka export create $PROJECT_ID --preset $PRESET_ID --wait

What’s next

Render settings reference - all shared preset fields
Projects - apply presets to project settings
Exports - apply presets at render time
Media - reusable media referenced by presets

Overview

Reference

`preset schema`

`preset list`

`preset show`

`preset create`

Options

Examples

`preset update`

`preset delete`

`preset default`

Applying a preset

What’s next

​preset schema

​preset list

​preset show

​preset create

​Options

​Examples

​preset update

​preset delete

​preset default

​Applying a preset

​What’s next

`preset schema`

`preset list`

`preset show`

`preset create`

Options

Examples

`preset update`

`preset delete`

`preset default`

Applying a preset

What’s next