Option Types Reference

Option Types Reference

Overview

Different option types appear as different kinds of personalization layers. This reference explains what each option type can do. Field names match the Layer settings panel — see Layer Settings for the full list.

Text Inputs (Text box, Text area)

Layer kind: Text

What it does: Customer text input appears as text on the product image.

Configuration:

  • Under Text: Default preview text, Font family, Size (px), Default color, Alignment
  • Under Default position & size: X, Y, Width, Height, Rotation (°), Arc curvature
  • Under Linked options: Font source, Color source, Font size source
  • Under Allow customer to: Change text position (drag), Change text field size (corner handle), Rotate text (top handle)

Example: Mug engraving where customers type their name. Link Font source, Color source, and Font size source so customers control font, color, and size.

Number Input, Slider

Layer kind: None (doesn't create a visual layer directly)

What it does: Controls a text layer's size or any other numeric sizing.

In personalization: Link to a text layer's Font size source so customers can resize text.

Example: A "Text size" slider. Link it as Font size source on an engraving text layer.

Layer kind: Image (overlay or background swap)

Configuration:

  • Under Image: Behavior when a value is selected — Show as overlay layer (positioned on top) or Swap the canvas background image; for overlays, set Shape
  • Under Preview images per value: map each value (Pick image / Change, or Auto-map by alt text)
  • Under Default position & size (overlay only): X, Y, Width, Height, Rotation (°)
  • Under Allow customer to (overlay only): Change image position (drag), Change image size (corner handle), Rotate image (top handle)

Example: A "Mug color" dropdown (Red, Blue, Green). Map each value to a different colored mug overlay under Preview images per value.

Checkbox Group

Layer kind: Image

Multi-select: Under Multi-select layout, set Mode to Slots — fill in selection order or Per value — each value has a fixed spot.

Configuration:

  • Set Mode and, for slots, Slot count
  • Position each slot or value
  • Set Shape and Preview images per value as needed
  • Under Allow customer to, enable drag / resize / rotate as needed

Example: "Toppings" checkboxes. Use Per value — each value has a fixed spot so each topping appears in the same place.

Color Swatch, Image Swatch

Layer kind: Image

Multi-select support: Yes for manually configured swatches (use Multi-select layout). Image swatch options with Image source → Shopify product variants do not support multiple selections — each value maps to one variant.

Configuration:

  • Set Behavior when a value is selected and Shape
  • For manual swatches, map images under Preview images per value
  • Position and size for overlay layers
  • Under Allow customer to (overlay only): Change image position (drag), Change image size (corner handle), Rotate image (top handle)

Shopify-synced image swatch — When Image source is Shopify product variants, each value's preview image comes from that variant's featured image. The mapping table is replaced by an info banner under Preview images per value. Configure the option in Options & Pricing. See Option Basic Settings and Layer Settings.

Example: "Logo color" color swatch — customers pick a color and the logo overlay updates. Pattern image swatch synced from Shopify — each variant's featured image appears when the customer picks that swatch.

File Upload

Layer kind: Image

Multi-select support: Yes (customers can upload one or more files)

Multi-select mode: Typically Slots — fill in selection order (file contents are the values)

Configuration:

  • Under Multi-select layout, set Mode and Slot count
  • Position each slot
  • Set Shape
  • Under Allow customer to: Change image position (drag), Change image size (corner handle), Rotate image (top handle)

Drag-to-reorder: On the storefront, customers can drag files between slots to reorder them.

Example: "Photo collage" with 4 slots in a 2×2 grid. Customers upload photos; each fills the next slot. They can move and resize each photo under the enabled Allow customer to checkboxes.

Font Picker

Layer kind: None (doesn't create a visual layer directly)

What it does: Controls text layer font family.

In personalization: Link as a text layer's Font source. When customers pick a font, text on the preview updates.

Example: "Engraving font" picker linked as Font source on a text layer.

Color Picker

Layer kind: None

What it does: Controls text layer color.

In personalization: Link as a text layer's Color source. When customers pick a color, text color updates.

Alternative: Link a Color swatch as Color source for predefined color choices.

Example: "Text color" color picker linked as Color source on an engraving text layer.

Dimensions

Layer kind: None (typically not used for overlays)

What it does: Captures multi-axis measurements.

In personalization: Not commonly used as a layer itself, but can provide sizing data for other calculations.

Not Supported

Product List — Cannot be used in personalization layers.

Combining Multiple Option Types

Most layers tie to one option, but you can stack multiple option layers and static overlays:

  • Layer 1: Color / image swatch (Swap the canvas background image)
  • Layer 2: Static overlay (lifestyle prop via Overlay image)
  • Layer 3: Text box (engraving text)
  • Layer 4: File upload (customer photo)
  • Layer 5: Font picker → linked as Font source on the text layer

All stack on the base image.