Configuring Personalization Options

Configuring Personalization Options

Overview

For each personalization layer, you define how it looks and behaves. Click a layer in the Layers panel (left side of Step 5: Personalization) to open the Layer Settings panel on the right. This is where you control positioning, sizing, customer interactions, and how the layer responds to option values.

Layer Positioning & Sizing

Position (X, Y) — Where the layer appears on the product image, measured in pixels from the top-left corner.

Size (Width, Height) — How large the layer displays, in pixels.

Rotation — Angle in degrees (0–360). For text layers, you can also set Arc curvature to bend text along a circular arc.

Move on canvas — To adjust position and size visually instead of typing numbers, click Edit on canvas. This lets you drag the layer's bounds directly in the preview.

Setting Default Values

Default image / Default text — What the layer displays when the associated option hasn't been selected or has no value. This preview text is what customers see before they make a selection.

For Text layers: The default text appears in the text box below the label.

For Image layers: If no image is selected, a dashed placeholder box appears in the preview.

Customer Controls

Decide what customers can do with each layer when they're on the storefront:

Change position — Customers can drag the layer to a different location on the preview.

Change size — Customers can resize the layer by dragging its corners or edges.

Rotate — Customers can rotate the layer (for image and text layers).

These are independent toggles — you can enable any combination. If all are disabled, the layer is static and customers see a fixed preview.

Linked Options (for Text Layers)

For text layers, you can link the text's appearance to other options in your calculator:

Font family — Select a Font picker option to let customers choose the font. If linked, the text uses the customer's font selection (not a default from the layer settings).

Font color — Link to a Color picker or Color swatch option. The text color updates when customers select a color.

Font size — Link to a Number input or Slider option. The text size changes based on the number the customer enters.

If you link any of these, the associated option's initial/default value is used when the calculator first loads. Merchants can still set a default text value, but the font appearance comes from the linked options.

Example: You have a "Mug Engraving" text layer with a linked Font family option and a linked Font size option. When a customer loads the page, the text uses the font and size from those options' defaults. As the customer changes the font or size, the preview updates in real time.

Text Layer Display Format

For text layers, you can set:

  • Placeholder text — Hint shown in the text input before the customer types
  • Default text — Text shown in the preview if the customer hasn't entered anything yet

Image Layer Configuration

For Image layer kind:

Image behavior — How the layer responds to option value changes:

  • Single image — The option has one image (from a swatch) that displays when the option is selected
  • Per-value image — Each option value can have its own specific image for this layer (useful for image swatches, file uploads, or when you want different images for different choices)

Image shape — How the image is cropped or masked:

  • Square — No masking; full rectangular image
  • Circle — Circular mask (e.g., for circular badges or profile photos)
  • Oval — Oval mask
  • Custom — Upload a mask image to create custom shapes. The uploaded image's transparency defines the shape (black = visible, transparent = hidden)

Layer Name & Type Badge

Each layer shows:

  • Name — You can edit this label in the layer settings to keep track (e.g., "Mug Color", "Customer Text", "Logo")
  • Type badge — Shows whether it's an Image, Text, or Background swap layer

Arranging Multiple Instances

For options that allow multiple selections (see Personalization Multi-Select Options), you'll see an Arrange in a row button. Click this to automatically position all sub-layers side by side, which is helpful when you first set them up.

    • Related Articles

    • Personalization

      Overview Personalization lets customers see a live preview of how their selections change a product's appearance. When customers choose options like colors, swatches, or upload files, those selections appear as layers overlaid on the product image. ...
    • Personalization

      Overview Personalization lets your customers see a live preview of how their choices change the appearance of a product. When customers select options (like colors, images, or text), those selections appear as layers on top of the product image. For ...
    • Configuring Options

      Overview Once you create a layer, configure how it behaves by clicking it in the Layers list and adjusting settings in the Layer Settings panel (right side). Here you set positioning, sizing, default values, what customers can do, and how the layer ...
    • Personalization Multi-Select Options

      Overview Some options allow customers to select multiple items: checkboxes, multi-file uploads, or multi-select swatches. When you add a personalization layer for a multi-select option, you can configure how those multiple selections appear as ...
    • Setting Up Personalization

      Overview Personalization is available as an optional feature in every calculator. Enable it in Calculator Editor → Optional Features → Step 5: Personalization and you'll see a three-panel workspace: Layers (left), Preview (center), and Layer Settings ...