> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/options/getting-started/quickstart.md).

# Quickstart

Five steps to get your first option live on a product page in under ten minutes.

The shortest complete path through the app. By the end, you’ll have a text field on your product page that customers can type into, and their input will be included with the order.

Everything you do in this guide is reversible.

**Watch it done — 2:19.** The same path as the steps below — create an option set, add a text field and image swatches, assign it to products, enable it on your theme.

{% embed url="<https://www.youtube.com/watch?v=ChC37ngqLM8>" %}

## Before you start

* The app is installed, and you have chosen a plan — see [Install the app](/options/getting-started/install-the-app.md).
* You know which theme is currently live, and you can open the Shopify theme editor.
* You have a product that you can open on your storefront to use for testing.

## Steps

{% stepper %}
{% step %}

### Create an option set and name it

Go to **Option Sets** > **Create option set** > **Create from scratch**.

Replace the default name in the builder header with a name you’ll recognize — `Engraving`, for example. This name is for internal use only; customers won’t see it.

The builder opens on **Build option**, with one empty **Section** already in place. A section is simply a container for your options — add your first option inside it.

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-a3c5d6fba8f15f45469df16c1344ec47c4f19ea5%2F2026-08-27_13-12-14.png?alt=media" alt="The Create option set menu open on the Option Sets page, showing Create from scratch and Use a template"><figcaption><p>Start a new option set from scratch on the Option Sets page.</p></figcaption></figure>

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-bef6043a72933fb38ef786b1e8841646c6330f14%2F2026-08-27_13-15-46.png?alt=media" alt="A newly created option set open in the builder with one empty section"><figcaption><p>A new option set opens on Build option, with one empty section ready for your first option.</p></figcaption></figure>
{% endstep %}

{% step %}

### Add a Text option and label it

Click the **Add option** button and select **Text** (it's the simplest of the 32 [option types](/options/option-types/option-types.md): a single-line box).

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-75aab5b228900df070b7b906ab0c2333373d96c7%2F2026-08-27_13-19-48.png?alt=media" alt="The Add option picker with option types grouped into Input, Selection, and Static"><figcaption><p>Add option lists all 32 option types, grouped into Input, Selection, and Static.</p></figcaption></figure>

On **Basic**, two fields matter:

* **Label** — what customers read above the box. Set it to `Engraving text`.
* **Name** — what appears on the cart, at checkout, and on the order. Set it to `Engraving text` too.

The preview on the right updates as you type.

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-d09253a6e86188224151f18370025364c2dcc068%2F2026-08-27_13-22-59.png?alt=media" alt="The option type picker open in the builder, showing the Input, Selection, and Static groups"><figcaption><p>Label is what customers read, and Name is what appears on the order.</p></figcaption></figure>

{% hint style="info" %}
**Name** has rules that **Label** does not: it must be unique within the option set, and it cannot contain `.` `:` `"` `'` `\` or `|`. See [Label and Name](/options/option-types/shared-settings/labels-and-visibility.md).
{% endhint %}
{% endstep %}

{% step %}

### Assign it to your products

Switch to **Assign products** and turn on **Apply to All Products**.

That is the fastest way to test. The other two methods — picking products by hand, or matching a tag, type, vendor, price, or collection — are what you will actually use in production. See [Assign to products](/options/option-sets/assign-to-products.md).

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-efad458429b201367723b8cc49d478101ec7f540%2F2026-08-27_13-25-46.png?alt=media" alt="The Assign products step with Apply to All Products turned on"><figcaption><p>Apply to All Products is the fastest way to test; narrow it down afterwards.</p></figcaption></figure>

{% hint style="warning" %}
An option set will not save without **at least one option** and **a product rule turned on**. If either is missing, the builder jumps you back to that step.
{% endhint %}
{% endstep %}

{% step %}

### Save it as Active

Select **Save**, then set the status beside the option set name to **Active** and tick **Online Store** under **Sales channels**.

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-623fc516de44977da838f13f7989fb8d9fa8bdfc%2F2026-08-27_13-28-39.png?alt=media" alt="The status menu in the builder with Active selected and Online Store ticked"><figcaption><p>An option set must be Active and published to Online Store to reach customers.</p></figcaption></figure>
{% endstep %}

{% step %}

### Enable the app embed

**This is the step most often missed.** Until the app embed is enabled in your theme, nothing you’ve built will appear on the storefront, no matter how the option set is configured.

Go to **Settings** > **Theme Setup**, confirm that the theme shown is your live theme, then select **Go to Theme Editor**. Turn on the **Globo Product Options** app embed and select **Save**.

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-914fc606aad6b1adc490de411ce8def1e9caf1b9%2F2026-08-27_13-31-37.png?alt=media" alt="The Theme Setup page with the selected theme and its app embed status"><figcaption><p>Theme Setup confirms which theme the app embed applies to.</p></figcaption></figure>

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-e879fc20c4cfbfefe5a1be0934769b0ccfb980b4%2F2026-08-27_13-33-31.png?alt=media" alt="The theme editor&#x27;s app embeds panel with the app embed switched on"><figcaption><p>Turn on the app embed in the theme editor, then save.</p></figcaption></figure>

Back in the app tab, it automatically changes to **Activated** within a few seconds.

There are two other ways to enable the app embed, as well as steps to verify that it’s working: [Enable the app embed](/options/getting-started/enable-the-app-embed.md).
{% endstep %}
{% endstepper %}

## See it on your storefront

Open any product page. Your **Engraving text** field should appear above the **Add to cart** button, which is the app’s default position.

Enter some text and add the product to your cart. The text is saved with the item and appears beneath it on the cart page, at checkout, and on the order in your Shopify admin.

<figure><img src="https://3141646361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkMyxhAk2ZlJa4wZQGfBI%2Fuploads%2Fgit-blob-0f9e0e28dd22262ad3bdd815dc3a2d1240af185b%2F2026-08-27_13-37-35.png?alt=media" alt="A storefront product page with the Engraving text field above the Add to cart button"><figcaption><p>The option appears above Add to cart, which is the app's default position.</p></figcaption></figure>

{% hint style="success" %}
That’s the complete workflow: **build → assign → activate → embed → verify**. Everything else in these docs is a variation of this process.
{% endhint %}

You can move the widget to another position on the product detail page, and restyle it to match your theme — see [Widget placement](/options/storefront-display-and-design/widget-placement.md) and [Match your theme style](/options/storefront-display-and-design/match-your-theme-style.md).