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.
Quick start
- Install the app from the Shopify App Store and open it from your Shopify admin.
- Create an option set. Go to Option sets, click Create option set, give it a name and add options.
- Choose where it applies — all products or specific products — then save.
- 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.
- In Shopify admin, go to Online Store → Themes and click Customize.
- Open a Products template.
- In the product information section, click Add block and choose Omni Options under Apps.
- 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 address input | |
| URL | Website URL input |
| Phone Pro | Phone number with country code |
| Text area | Multiple lines of free text |
| Number | Numeric input with optional min/max |
| Number group Pro | A set of labeled numbers with a unit, like width × height |
| File upload Pro | Let customers attach a file |
| Date / time Pro | Date and time picker |
| Color picker Pro | Free color selection (HEX) |
| Font picker Pro | Choose 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