Troubleshooting

Fixes for the most common reasons options are not showing up or not working as expected.

Most reports have one of the causes below. Check the first one first, because it is the most common.

Options are not showing up

Nothing from the app appears on the storefront at all

Check these four items in order:

1. The app embed is not enabled on your live theme. This is the most common cause. The app embed is per theme, so publishing a new theme turns it off. See Enable the app embed.

2. The option set is Draft. A draft option set is never displayed. See Activate and publish.

3. Online Store is not selected under the option set's Sales channels.

4. The product rule does not match the product you are viewing. Use Preview matching products to check. See Assign to products.

If all four are correct, report this issue to us. See Contact support.

Some options appear and others do not

There are three likely causes: conditional logic is hiding them, the Hide action is applied to them, or your plan does not include those option types, so they are configured but not displayed.

Options appear twice on one product

Either two active option sets match the product, or automatic placement and an app block are both placing the widget. For the first cause, filter the list to Active and look for an option set using Apply to All Products. For the second, remove one of the two.

Options disappeared after I published a theme

The app embed is not enabled on the new theme. The app embed is per theme, including a duplicate of the same theme.

Options show on the storefront but not in POS, or the reverse

Check the option set's Sales channels. It has to be published to the channel you expect it on. Then confirm that the option types you used are supported in POS. Dimension and Product links are not supported, and Fixed amount add-ons are not charged there. See POS limitations.

Pricing and add-ons

An add-on charge is missing, wrong, or doubled

• Nothing is charged. Check that the option is not hidden by a conditional rule, as hidden options are not charged. Also make sure the price is set and the option set is saved and active.

• The charge multiplies when a customer buys several. The option is set to Default mode, which follows the product quantity. Use One-time charge for anything charged once per order, such as gift wrap. See Advanced add-on modes.

• Every selected value is charged on a multi-select. This is correct. Limit it with Max selections.

The product price is higher than my listed price before anything is selected

An option has a default value with a price attached, so it is charged as soon as the page loads. Either remove the default value or set the default to a value with no price. See Required field and default value.

No price appears beside an option

Settings > Settings > Add-on price has two settings. Show add-on for inputs covers Text, Textarea, and Number, and Show add-on for options covers the selection types. Check that the one covering your option type is on. See Add-on price display settings.

Out of stock options does nothing

There are three causes. The values use Add Price, which has no product and therefore no inventory. The add-on product does not have inventory tracking turned on. Or the variant is still set to continue selling when out of stock. For generated products, the last two have to be set manually. See Stock and inventory.

Generated add-on products appear in my collections and search

Exclude the tag globo-product-options from those collections. Do not unpublish the products from the Online Store, because an unpublished product cannot be added to the cart. See New product.

Cart and checkout

Add to cart does nothing

This is usually a validation failure rather than a broken button: a required option is empty, or an entry exceeds a limit. Turn on Auto-scroll to first error message in Settings > Settings > General so customers are taken to the field with the error. It is on by default, and with it off, customers see no feedback.

Customers can add to cart without seeing the options

Two things bypass the form: a quickview whose product form the app cannot find on your theme, and a sticky add-to-cart bar whose button does not go through the app. Both produce orders you cannot fulfill, so report either of them. See Theme and third-party notes.

The accelerated payment buttons disappeared

This is expected on products with options. Those buttons skip the cart, which would skip the option form, so the app hides them where options are present.

Customers delete add-on lines and break their orders

Turn on Hide quantity box and remove button for add-on products in Settings > Settings > General. It is on by default. Without it, a customer can remove the gift box while keeping the "gift wrapped" option.

Option details are missing from my packing slip

The template does not print line item properties. Add the snippet from Show options on orders inside the line item loop, or use an Order notes update workflow, because most templates already print the order note.

Odd technical entries appear on my paperwork

Your template is printing every property, including the app's internal ones. The snippet in Show options on orders skips property names beginning with an underscore.

Order lines read as "text" or "checkbox"

Those are the options' Name values, left at their defaults. Set them to readable values. The change applies to future orders. See Label and Name.

Appearance and behavior

The widget looks nothing like my theme

Turn on Match theme style in Settings > Design, and check whether your theme is listed under the View supported themes link beside it. If it is not listed, set the colors, borders, and fonts manually. See Match your theme style.

The widget is in an odd place on the page

Change Widget placement in Settings > Settings > General, or set the position exactly with an app block. See Widget placement.

The widget appears late, after the page has loaded

This is usually a speed or script optimization app deferring the app's scripts. Add this app to its exclusion list. See Theme and third-party notes.

A feature or option type is grayed out, or displays an upgrade prompt

The feature is not included on your current plan. See Compare plans.

Messages the app shows you

These messages appear in the builder while you configure an option, and prevent you from saving something that would not work. :field is replaced with the name of the setting.

Message	What it means
"Name must be unique. Please enter a different value."	Two options in the set share a Name, ignoring capitalisation and spaces. A duplicated option is the usual cause — rename the copy. See Label and Name
"Name cannot contain any of the following characters . : ' \ |"	Remove the character. Apostrophes are the most frequent offender: use Customers note as the Name and put Customer's note in the Label
"Value must be unique"	Two option values match once capitalisation and spaces are ignored. Look for a trailing space, or Red and RED in the same table
"Value can't contain any of the following characters , : ' |"	An option value or tab title contains a blocked character. See Working with option values
"The value must be between min and max"	A default value falls outside its own limits. Change the default, or widen the range. See Limits
"The value must be greater than min" / "less than max"	Min and max are the wrong way round
"The value must be between 1 and the number of option values"	Your min or max selections is higher than the number of values the option has. Add values, or lower the limit
"The value must be between 1 and 20 (or max)"	A file count outside the permitted 1–20 range
"Formula cannot contain subtraction"	Remove the - from a dimension formula. Rewrite it using multiplication, addition, and division. See Dimension add-on formula
"This product does not exist on your store anymore."	A linked add-on product was deleted in Shopify. Select a different product, or recreate it
"This variant does not exist on your store anymore. Please select another."	The linked variant was deleted or changed. Reopen the price dialog and pick a current one
"Please select product to apply this option set."	Manual Selection is on with nothing selected. Select products, or switch method. See Assign to products
"Please select customer to apply this option set."	The same for the customer rule — select customers, or switch to Everyone
"HTML class only accepts letters, numbers, hyphens and underscore"	That is the option's HTML class field, not the CSS editor. Remove the offending character — usually a leading dot. One class name per option
"This element has reached the maximum number of font options (30)"	Thirty is the ceiling per Font picker. Remove some fonts
"File type must be .woff2, .woff, .ttf or .otf"	A custom font upload in an unsupported format. Convert it, or ask your supplier for a web format. See Custom fonts
"Invalid email" on an address that looks correct	Check for a trailing space, a comma instead of a full stop, or two addresses in one field. Only one address per field is accepted
"Upgrade required", or a grayed-out setting	The feature is not on your plan. See Compare plans

Conditional logic and the Personalizer

Both have their own troubleshooting page, organized by symptom:

• Troubleshooting conditional logic covers rules running at the wrong time, options that will not hide, and variant conditions.

• Troubleshooting personalizer covers nothing being drawn, an incorrect position, the wrong font, and unusable customer designs.

Still stuck?

See the FAQ for quick answers, or Contact support with your theme name, the option set name, and a link to the product page.