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

# Connect options to your design

> Point each option at a layer so your customer's answer changes the artwork.

An option on its own only collects an answer. A **connection** is what tells Customei to do something with it: write it onto a layer, swap a picture, change a colour.

Every connection is the same three-part sentence:

> **This option**  ·  **does this**  ·  **to this layer**

Get those three right and the shopper sees the design change as they type.

## Step 1. Check which design template you're working against

An option set can only connect to layers in the design template it uses. That template is shown at the top of the preview panel, on the right of the editor.

<Frame caption="The preview panel header names the design template this option set uses.">
  <img src="https://mintcdn.com/nexlify/8a0A2XY3gmNS0J-E/images/optionsets/attached-template.png?fit=max&auto=format&n=8a0A2XY3gmNS0J-E&q=85&s=7d716a1a411661503e0570c0fdb94875" alt="The option set editor with the preview panel header highlighted, showing the word Template followed by the template name and three icon buttons." width="3200" height="2000" data-path="images/optionsets/attached-template.png" />
</Frame>

The three buttons beside the name are:

| Button                | What it does                                           |
| --------------------- | ------------------------------------------------------ |
| **Open live preview** | Opens a full preview of the design with your options   |
| **Change template**   | Swaps this option set onto a different design template |
| **Remove template**   | Detaches the design template entirely                  |

If your option set was created from a template, the right one is already in place and you can skip to step 2. If the panel has no template, or you picked the wrong one, click **Change template**.

<Frame caption="The template picker. Search by name, then click a card to use it.">
  <img src="https://mintcdn.com/nexlify/8a0A2XY3gmNS0J-E/images/optionsets/change-template.png?fit=max&auto=format&n=8a0A2XY3gmNS0J-E&q=85&s=79ed8c2976c177744fa57184eefbdf81" alt="The Select a design template dialog showing a searchable grid of design template cards with their sizes and last-updated dates." width="3200" height="1952" data-path="images/optionsets/change-template.png" />
</Frame>

<Warning>
  Changing the template repoints the whole option set at different artwork. Connections that referred to layer numbers in the old design will now point at whatever happens to carry those numbers in the new one, so check every option afterwards.
</Warning>

## Step 2. Find the layer number

Open your design template and look at the **Layers** panel. Every layer has a number.

<Frame caption="Layer #14 is the text layer named Kid's Name. That number is what you connect to.">
  <img src="https://mintcdn.com/nexlify/yEnmlzRdJt9xAe2N/images/templates/layer-numbers.png?fit=max&auto=format&n=yEnmlzRdJt9xAe2N&q=85&s=6df3c7077fea5e8ddc9b30cc88981438" alt="The Layers panel of a design template, with the row for layer #14 Kid's Name highlighted." width="3200" height="2000" data-path="images/templates/layer-numbers.png" />
</Frame>

Keep that number handy. It's the third part of the sentence.

## Step 3. Add the connection

Select an option, scroll to **Template connections**, and click **Add connection**.

<Frame caption="Enter Year writes the customer's text onto layer #14.">
  <img src="https://mintcdn.com/nexlify/yEnmlzRdJt9xAe2N/images/optionsets/template-connections.png?fit=max&auto=format&n=yEnmlzRdJt9xAe2N&q=85&s=6dd70c1e6cf3f07f1cfebce49e170a54" alt="The Template connections card highlighted, showing a Text connection pointing at Kid's Name, layer #14." width="3200" height="2000" data-path="images/optionsets/template-connections.png" />
</Frame>

Reading that card out loud: the option **Enter Year** puts its **Text** onto layer **#14**, which is called **Kid's Name**. When a shopper types `2026`, the words on that layer become `2026`.

Two boxes make up each connection:

* The **left box** is what happens: Text, Dynamic image, Text colour, and so on.
* The **right box** is which layer it happens to. Start typing a layer name or number and pick from the suggestions.

Click **Add another connection** if one answer should change more than one thing, for instance a colour swatch that recolours both the wording and the border.

## Swapping a picture instead of text

Selection options work the same way, but the thing that changes is usually an image.

<Frame caption="A swatch option connected to Dynamic image on layer #3.">
  <img src="https://mintcdn.com/nexlify/yEnmlzRdJt9xAe2N/images/optionsets/dynamic-image-connection.png?fit=max&auto=format&n=yEnmlzRdJt9xAe2N&q=85&s=677ddad44692140faf0eaf009adce638" alt="The Template connections card for a swatch option, highlighted, showing a Dynamic image connection pointing at Choose Skin For 1st Woman, layer #3." width="3200" height="2000" data-path="images/optionsets/dynamic-image-connection.png" />
</Frame>

Here the option *Choose Skin For 1st Woman* is a swatch with four choices. The connection says **Dynamic image → #3**, so picking a swatch swaps the picture on layer `#3`.

The **Wizard** link at the top right of the card opens a grid where you map every choice to its picture in one pass, instead of one at a time. On an option with a dozen values, this is much faster.

## What a connection can do

Click the left box to see what's available.

<Frame caption="The connection list for a text option. Only the actions that make sense for typing are offered.">
  <img src="https://mintcdn.com/nexlify/yEnmlzRdJt9xAe2N/images/optionsets/connection-types.png?fit=max&auto=format&n=yEnmlzRdJt9xAe2N&q=85&s=7688323c7d161dfa83b3d56826953f2e" alt="The connection type dropdown for a text option, listing Text, Dynamic image, QR Code, Crossword, Word Search and Word Cloud." width="500" height="632" data-path="images/optionsets/connection-types.png" />
</Frame>

Customei only offers the actions that make sense for the option's type. A colour picker can't type words onto a layer, so it isn't offered.

| Connection                                     | What it changes                                   |
| ---------------------------------------------- | ------------------------------------------------- |
| **Text**                                       | The wording on a text layer                       |
| **Font style**                                 | The font a text layer uses                        |
| **Text colour**                                | The fill colour of text                           |
| **Text stroke**                                | The outline colour of text                        |
| **Image colour**                               | A colour wash over an image                       |
| **Dynamic image**                              | Swaps the picture on a layer                      |
| **Customer upload**                            | Places the shopper's own photo on a layer         |
| **QR Code**                                    | Builds a code from what the shopper enters        |
| **Calendar**                                   | Shows the chosen date as a calendar               |
| **Moon phase**                                 | Shows the moon on the chosen date                 |
| **Star map**                                   | Shows the night sky on the chosen date            |
| **Map location**                               | Moves the map to the place the shopper picked     |
| **Map style** and **Star map style**           | Restyles the map or star map                      |
| **Crossword**, **Word Search**, **Word Cloud** | Builds a puzzle or cloud from the shopper's words |
| **Spotify player**                             | Fills the player from a track link                |
| **Switch design template**                     | Swaps the whole design for a different template   |
| **Add product**                                | Adds another Shopify product to the cart          |
| **Group visibility**                           | Shows or hides a whole group of layers            |

### Which option type offers which

| Option type                                                   | Connections available                                                                                                                                               |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Text input                                                    | Text · Dynamic image · QR Code · Crossword · Word Search · Word Cloud                                                                                               |
| Dropdown, Radio buttons, Swatch, Dropdown swatch, Text swatch | Text · Text colour · Text stroke · Font style · Dynamic image · Image colour · Map style · Star map style · Switch design template · Add product · Group visibility |
| Checkbox                                                      | Text · Text colour · Text stroke · Font style · Dynamic image · Image colour                                                                                        |
| Colour picker                                                 | Text colour · Text stroke · Image colour                                                                                                                            |
| File upload, Image upload                                     | Customer upload                                                                                                                                                     |
| Date picker                                                   | Text · Calendar · Moon phase · Star map                                                                                                                             |
| Map                                                           | Map location                                                                                                                                                        |
| Spotify Player                                                | Spotify player                                                                                                                                                      |
| Crossword style                                               | Crossword                                                                                                                                                           |
| Countdown                                                     | None. It's shown on the page but doesn't change the design                                                                                                          |

<Tip>
  The **?** beside the connection type plays a short animation of exactly what that action does to a design. It's the quickest way to decide between two that sound similar.
</Tip>

## Let the design template update your options for you

Connections point *from* an option *to* a layer. There's also a link running the other way: a design template can keep this option set's options up to date on its own.

Click **Settings** in the header to see it.

<Frame caption="Settings shows which design template feeds this option set, and lets you cut the link.">
  <img src="https://mintcdn.com/nexlify/yEnmlzRdJt9xAe2N/images/optionsets/linked-template.png?fit=max&auto=format&n=yEnmlzRdJt9xAe2N&q=85&s=589eb890f04c8ee682fc8903861131e1" alt="The Option set settings dialog showing the set name and a Linked design templates section listing one template with the note Layers and library bindings drive fields here, and an Unlink action." width="3200" height="806" data-path="images/optionsets/linked-template.png" />
</Frame>

While a template is linked here, its layers drive the options in this set. Rename a layer, add a new one, or change the graphics a layer can use, and the matching options update by themselves. You don't have to rebuild anything by hand. That's what *"Layers and library bindings drive fields here"* means.

This link is set up for you when you create an option set from a design template.

<Warning>
  **Unlink** keeps every option exactly as it is, but the design template stops feeding it. Future changes to the template no longer reach these options. Any live product using this option set is also marked as out of date until you publish again. Only unlink if you deliberately want the options to stop following the template.
</Warning>

## When nothing changes in the preview

Work down this list. It's almost always one of these.

<Steps>
  <Step title="The option has no connection">
    A **Connect to template** empty state in the card means nothing is wired up yet. The option collects an answer and then throws it away.
  </Step>

  <Step title="The connection points at the wrong layer">
    Check the number in the right box against the Layers panel in your template. It's easy to grab `#4` when you meant `#14`.
  </Step>

  <Step title="Two layers share the same number">
    Layer numbers can repeat within one template. When they do, Customei asks which layer you meant as you pick it. If you chose the wrong one, delete the connection and add it again.
  </Step>

  <Step title="The layer is hidden">
    A layer switched off in the template won't show your customer's answer either. Look for the crossed-out eye beside it in the Layers panel.
  </Step>

  <Step title="You haven't saved">
    Changes only take effect once you hit **Save** on the save bar at the top.
  </Step>
</Steps>

## Where to next

<CardGroup cols={2}>
  <Card title="Assign products and go live" icon="rocket" href="/go-live/publish-and-assign">
    Put the option set on a product page.
  </Card>

  <Card title="Create a design template" icon="pen-ruler" href="/templates/create-a-template">
    Add or rename the layers you want to connect to.
  </Card>
</CardGroup>
