> ## 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.

# Manage your values

> Add, reorder, and rename the choices inside an option, and decide which one is pre-selected.

A **value** is one of the choices inside an option. If your option is "Choose a skin tone", each skin tone is a value. If it is "Ring size", each size is a value.

Select an option in the list and its values appear in the middle column.

<Frame caption="The values of a swatch option, with the tools for editing them along the top.">
  <img src="https://mintcdn.com/nexlify/jObu3-blJWj5gxav/images/optionsets/values-editor.png?fit=max&auto=format&n=jObu3-blJWj5gxav&q=85&s=1a24cbefea2d0efb1aa96f4c8f7de1ac" alt="The Swatch values card highlighted, showing Choose default, Bulk edit and Quick add buttons, a table with columns numbered hash, Value, Label and Add-on price in USD, four rows each with a drag handle, a swatch thumbnail, a value field and a price field, and an Add value button at the bottom." width="1092" height="1744" data-path="images/optionsets/values-editor.png" />
</Frame>

## Adding and removing

**Add value** at the bottom of the list creates an empty row. The bin icon at the end of a row removes that value.

<Warning>
  Removing a value that is already connected to your design breaks that connection. If a customer's choice pointed at that value, the layer it controlled no longer has anything to show. Check the **Template connections** card below the values before you delete.
</Warning>

## Reordering

Drag the handle at the left of a row to move a value up or down. The order here is the order the customer sees on your product page, so put the popular choices near the top where nobody has to scroll for them.

## Value and label are two different things

Each row has a **Value** and a **Label**, and they do different jobs.

* The **Value** is the internal name. It is what your design connects to, and it never changes once things are wired up.
* The **Label** is what the customer reads on your product page.

Keeping them separate is what lets you rename "1" into "Fair" for shoppers without breaking the connection to the layer it drives. If you leave the label empty, the customer sees the value instead.

<Tip>
  Write labels the way a customer would say them out loud. "Rose gold" sells better than "RG-02", and it costs you nothing to keep the tidy internal name underneath.
</Tip>

## Choosing what is pre-selected

**Choose default** sets the value a customer starts on before they touch anything.

<Frame caption="Choose default lists every value, plus a No default option.">
  <img src="https://mintcdn.com/nexlify/jObu3-blJWj5gxav/images/optionsets/choose-default.png?fit=max&auto=format&n=jObu3-blJWj5gxav&q=85&s=d483bad43c972f6c9d9152d52e966a89" alt="The Choose default popover open below its button, listing No default with a tick beside it, followed by four swatch values numbered 1 to 4." width="334" height="530" data-path="images/optionsets/choose-default.png" />
</Frame>

Pick a value to pre-select it, or pick **No default** to start with nothing chosen. Which one you want depends on the option:

* **Set a default** when there is an obvious common choice. It removes a decision and gets the shopper to the cart faster.
* **Use no default** when the choice is genuinely personal, or when picking for them risks an order they did not mean to place.

<Warning>
  A value that carries an extra charge cannot be pre-selected. This is deliberate: it stops a customer starting on a price they never agreed to. See [Charge extra for a choice](/optionsets/value-price-add-ons).
</Warning>

## Values that come from your design

Some options are filled in from the design template rather than typed by you. Those rows are locked, and hovering one tells you they are synced from a design template and cannot be edited here.

That is working as intended. The design is the source of the list, so change it there and the option follows. It keeps the choices on your product page and the layers in your template from drifting apart.

## Where to next

<CardGroup cols={2}>
  <Card title="Bulk edit values" icon="table" href="/optionsets/bulk-add-and-edit-values">
    Paste in a long list instead of adding rows one at a time.
  </Card>

  <Card title="Charge extra for a choice" icon="tag" href="/optionsets/value-price-add-ons">
    Add a surcharge to a specific value.
  </Card>

  <Card title="Show or hide options" icon="eye" href="/optionsets/conditional-logic">
    Only ask what is relevant.
  </Card>

  <Card title="Connect to a template" icon="link" href="/optionsets/connect-to-a-template">
    Point a value at a layer in your design.
  </Card>
</CardGroup>
