Documentation

Omni Options guide

Everything you need to add custom product options to your Shopify store — from your first option set to add-on pricing, file uploads and styling.

Overview

Omni Options lets you add extra fields to your products — personalization text, swatches, dropdowns, file uploads and more. What the customer chooses is saved on the cart line and flows through to checkout and the order in your Shopify admin.

Option setA group of options you build once and apply to products.
OptionOne field in a set, such as “Engraving text”.
ChoiceA selectable value of an option, such as “Red”.

Quick start

  1. Install the app from the Shopify App Store and open it from your Shopify admin.
  2. Create an option set. Go to Option sets, click Create option set, give it a name and add options.
  3. Choose where it applies — all products or specific products — then save.
  4. Add the app block to your product template (see below). Your options now appear on the product page.

Add the app block

Options are shown on your storefront through a theme app block, so no code changes are needed. It works with Online Store 2.0 themes.

  1. In Shopify admin, go to Online Store → Themes and click Customize.
  2. Open a Products template.
  3. In the product information section, click Add block and choose Omni Options under Apps.
  4. Drag it to where it should appear (usually above the Add to cart button) and save.

The app dashboard shows whether the block is enabled on your live theme, so you can check the setup at any time.

Option sets

An option set is a reusable group of options. You can create as many as you need on every plan.

  • Applies to all products — the set shows on every product. You can still exclude individual products.
  • Applies to specific products — pick products with the Shopify product picker.
  • Enable / disable a set at any time without deleting it.
  • Drag options to reorder them. The order in the editor is the order on the storefront.

Per-product options

The Products page lists your products and the option sets attached to each one. From there you can assign an existing set to a product, or create options that belong to a single product only — useful when one product needs its own unique fields.

Option types

21 option types are available, grouped the same way as in the editor. Types marked Pro need the Pro plan.

Selection

Dropdown Choose one value from a dropdown
Image swatch Pick one option represented by an image
Multi-select image swatch Pick several image based options
Checkboxes Choose one or more values
Radio buttons Choose one value from a list
Color swatch Pick one color from swatches

Inputs

Text field Single line of free text
Email Email address input
URL Website URL input
Phone ProPhone number with country code
Text area Multiple lines of free text
Number Numeric input with optional min/max
Number group ProA set of labeled numbers with a unit, like width × height
File upload ProLet customers attach a file
Date / time ProDate and time picker
Color picker ProFree color selection (HEX)
Font picker ProChoose a font from Google Fonts

Content

Divider A horizontal line
Spacer Vertical space
Heading A section heading
Paragraph A block of text

Content types (Divider, Spacer, Heading, Paragraph) only change the layout of your options. They don’t collect a value.

Option settings

Every option supports:

  • Label — the name shown to customers and saved on the order.
  • Description — help text shown under the label.
  • Required — customers can’t add to cart until it’s filled in.

Depending on the type you can also set:

  • Placeholder text, minimum and maximum characters, and a character counter.
  • Minimum and maximum values for numbers.
  • Choices with images or colors for swatches, and a default choice.
  • For Number group Pro: up to 4 labeled fields with a unit, such as width × height in cm.
  • For File upload Pro: allowed formats, maximum number of files and maximum file size.

Conditional logic

Show or hide an option based on other selections, so customers only see what’s relevant. Open an option, turn on Conditional visibility, then choose:

  • Action — show or hide this option.
  • Match — when all rules or any rule is met.
  • Rules — “when [option] [is / is not / contains] [value]”.

Rules based on other Omni Options options are free. Rules based on Shopify variants (e.g. show “Engraving” only when Size is “Large”) need Pro.

Tabs Pro

Long option sets can be split into tabs or steps so the product page stays tidy. Create tabs in the option set, then assign each option to a tab. Tab colors and styles are set on the Customize page.

Add-on pricing

Charge extra for an option (e.g. +$5 for engraving) or for a specific choice (e.g. +$4 for gift wrap). The total add-on is shown to the customer before they add to cart and is charged at checkout automatically.

  • Free plan — add-on pricing on up to 5 products.
  • Pro plan — add-on pricing on unlimited products.

Depending on your store, add-ons are either built into the product’s price at checkout or added as a separate hidden “Add-on” line. The app sets this up for you.

File uploads Pro

Let customers upload logos, photos or artwork with their order.

  • Up to 20 MB per file, and you choose which file formats are allowed.
  • Files are uploaded safely after checkout and linked to the order.
  • Find, preview and download every file on the Files page, or from the Omni order files block on the Shopify order page.
  • Pro includes 3 GB of storage. Need more? Buy extra storage in 1 GB add-ons on the Files page.
  • Files are deleted when the order is deleted in Shopify.

Orders & notifications

Selections are saved as line item properties, e.g. Color: Red. They show in the cart, at checkout and on the order in your Shopify admin.

To include them in Order confirmation or New order emails, go to Settings → Notifications, edit the template and add this inside the product line loop:

{% for property in line.properties %}
  {% assign first_char = property.first | slice: 0, 1 %}
  {% unless first_char == '_' or property.last == blank %}
    {{ property.first | escape }}: {{ property.last | escape | newline_to_br }}<br>
  {% endunless %}
{% endfor %}

For packing slips, use the same snippet in Settings → Shipping and delivery → Packing slips, with line_item instead of line. Internal properties start with _ and stay hidden.

Customize styles

Make options match your theme from the Customize page, with a live preview:

  • Fonts (including Google Fonts), sizes, weights and colors.
  • Option backgrounds, borders, corner radius and spacing.
  • Swatch sizes and the selected or focused state.
  • Tab, divider and file-upload styles.

Custom CSS Pro

For full control, add your own CSS on the Customize page. It’s loaded together with the option block on your storefront.

Export / import Pro

Export option sets and style settings to a file, and import them into another store or back into the same one. It’s a quick way to copy a setup or keep a backup.

Plans & billing

Free

  • Unlimited option sets, orders & products
  • Specific options for each product
  • 15 basic option types
  • Price add-on for 5 products
  • Conditional logic based on Omni Options
  • Customize option styles
  • Standard support

Pro

  • All in Free plan
  • All Pro option types
  • Price add-on for unlimited products
  • Shopify variants based conditions
  • File upload (up to 20 MB)
  • 3 GB file storage
  • Export / import option sets & styles
  • Priority support
  • Billing is handled by Shopify and appears on your Shopify invoice.
  • Upgrade, switch between monthly and yearly, or cancel from the app’s Plans page.
  • When you downgrade, Pro features stay available until the end of the billing cycle. Your data is kept, so Pro features work again when you resubscribe. Editing and saving an option set while on Free removes Pro options and settings from that set.

Uninstall & data

When you uninstall the app, your subscription is canceled automatically. Your data is kept for 30 days and then permanently deleted. Reinstall within 30 days and everything is restored.

To remove the block from your theme, delete it in the theme editor. Want your data deleted right away? Contact support. See also our Privacy Policy.

Getting help

Can’t find what you need? Our team is happy to help with setup, styling or theme compatibility.

Visit support