Deck Item Label

The deckItemLabel setting controls how deck items are labeled in the admin interface. It uses the same template syntax as the autogen setting (see ID Autogen documentation), but displays raw values without slugification.

Default: ${id} (displays the item's ID)

Basic Usage

{
    "deckItemLabel" : "${rating} - ${name}"
}

Supported Placeholders

• Field values: ${fieldName} - Any field from the deck item schema
• Multiple fields: ${id} - ${title} - Combine multiple fields with separators
• Nested values (dot notation): ${field.key} - Reach into a composite field's value:
  • ${card.title} - a sub-field of a card field
  • ${headline.es} - a single locale of a localizedtext / localizedstyledtext field
  • ${card.headline.es} - both at once (a localized sub-field inside a card)
  • A bare ${card} or ${headline} (a composite value with no sub-key) resolves to nothing rather than a raw dump — point at the part you want.
• Dynamic values (new items only):
  • ${uid} - Random unique ID
  • ${uuid} - Full UUID
  • ${now} - Current timestamp
  • ${currentyear}, ${currentmonth}, ${currentday} - Date components

Examples

Simple ID display:

"deckItemLabel": "${id}"

Rating and name:

"deckItemLabel": "${rating} ★ - ${name}"

Important Notes

Note: ${oid} is not supported for deck items. Use ${uuid} or ${uid} for auto-generated deck item IDs instead.

• No slugification: Values are displayed as-is without URL-safe transformation. If a field contains "The Big Red Fox", the label will show exactly that.
• Twig compatibility: Deck item IDs are automatically sanitized to use underscores instead of hyphens for Twig dot notation access (mydeck.item_id).
• SVG support: If a field contains SVG code, it will be displayed as a small icon in the label.
• Long text: Labels automatically truncate with ellipsis (...) if content is too long.

Min/Max Item Count

The minItems and maxItems settings control how many items a deck field can contain.

Basic Usage

{
    "minItems": 1,
    "maxItems": 5
}

Examples

Require at least one item:

"minItems": 1

Validation will fail with "Please add at least 1 items" if the deck is empty on submit.

Limit to a maximum of 3 items:

"maxItems": 3

The add and duplicate buttons will be disabled once 3 items exist. Removing an item re-enables them.

Exact count (e.g., exactly 3 items):

{
    "minItems": 3,
    "maxItems": 3
}

Modal Size

The modalSize setting controls how large the deck item edit modal opens in the admin.

Basic Usage

{
    "modalSize": "medium"
}