# Product Options > Unlimited custom options with add-on pricing and file uploads Source: https://help.pasilobus.com/product-options Shopify App Store: https://apps.shopify.com/product-options-pasilobus (listed as "Pasilobus Product Options") Price: Free plan · paid from $9.99/month Shopify Sidekick: ask about this app in your Shopify admin; Sidekick searches these guides. Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Every article in one file: https://help.pasilobus.com/product-options/llms-full.txt ## Getting started Install and understand the app basics - [Installation](https://help.pasilobus.com/product-options/installation.md): Install the app and activate it on your theme - [How Product Options works](https://help.pasilobus.com/product-options/how-product-options-works.md): Understand the key components of product customization - [Dashboard overview](https://help.pasilobus.com/product-options/dashboard-overview.md): Navigate the app and understand your metrics ## Features Configure product options across your store - [Option groups](https://help.pasilobus.com/product-options/option-groups.md): Organize options into reusable groups - [Option types](https://help.pasilobus.com/product-options/option-types.md): Choose the right input type for each option - [Product collection option](https://help.pasilobus.com/product-options/product-collection.md): Let customers pick a product (and variant) from a Shopify collection as an option - [Option values & pricing](https://help.pasilobus.com/product-options/option-values.md): Set up choices and additional pricing - [Quantity settings](https://help.pasilobus.com/product-options/quantity-settings.md): Control how option quantities work - [Conditional logic](https://help.pasilobus.com/product-options/conditional-logic.md): Show or hide options based on other selections - [Cart & checkout display](https://help.pasilobus.com/product-options/cart-checkout-display.md): Configure how options appear in cart and checkout - [Image galleries](https://help.pasilobus.com/product-options/file-galleries.md): Let customers choose from pre-uploaded images - [Product targeting](https://help.pasilobus.com/product-options/product-targeting.md): Control which products show your options - [Translations](https://help.pasilobus.com/product-options/translations.md): Customize text and support multiple languages - [Custom CSS](https://help.pasilobus.com/product-options/custom-css.md): Style option elements with CSS - [Orders & CSV export](https://help.pasilobus.com/product-options/orders-export.md): Review orders with customizations and export them to a spreadsheet ## Integrations Connect Product Options to Shopify's own tools - [Shopify Flow](https://help.pasilobus.com/product-options/shopify-flow.md): Automate work on orders with customizations and uploads ## For developers Technical integration guides - [Theme integration](https://help.pasilobus.com/product-options/theme-integration.md): Manual integration for custom themes ## Troubleshooting Common issues and solutions - [Options not showing](https://help.pasilobus.com/product-options/options-not-showing.md): Fix invisible product options - [Pricing issues](https://help.pasilobus.com/product-options/pricing-issues.md): Fix option pricing problems - [Styling issues](https://help.pasilobus.com/product-options/styling-issues.md): Fix appearance problems --- # Installation > Install the app and activate it on your theme Source: https://help.pasilobus.com/product-options/installation App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Getting started Last updated: 2026-08-10 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Getting Product Options running on your store takes just a few minutes. Install from the Shopify App Store, then follow the guided setup wizard to add the options block to your theme—no code required. ## Installing from the App Store 1. Visit the [Product Options](https://apps.shopify.com/product-options-pasilobus) app listing on the Shopify App Store 2. Click **Add app** to begin the installation 3. Follow the prompts to complete installation ## Theme Setup Wizard After installation, the theme setup wizard guides you through activating Product Options on your storefront: 1. **Choose theme** - Select which theme to install on 2. **Enable app embed** - Activates Product Options functionality 3. **Add options block** - Places the options form on product pages The wizard handles all theme integration automatically. ## Adding the App Block The Product Options block displays your custom options on product pages: 1. Go to **Online Store > Themes > Customize** 2. Select **Products > Default product** from the page dropdown 3. In the product section, click **Add block** 4. Choose **Product Options** from the Apps list 5. Drag to position (typically below variant selector, above Add to Cart) 6. Click **Save** ## Verifying Installation To confirm Product Options is properly installed: 1. Create an option group with at least one option 2. Assign a product to the option group 3. Open that product page in a new browser tab 4. Look for your custom options on the page If you don't see the options, check the [Options Not Showing](https://help.pasilobus.com/troubleshooting/options-not-showing) troubleshooting guide. --- # How Product Options works > Understand the key components of product customization Source: https://help.pasilobus.com/product-options/how-product-options-works App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Getting started Last updated: 2026-03-19 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Product Options lets you add custom fields to your products—from simple dropdowns to file uploads. Customers see these options on product pages and their selections carry through to cart and checkout. Understanding how the system works helps you create better customization experiences. ## The Product Options System The app uses a simple hierarchy to organize customization: - **Option Groups** contain one or more options - **Product Options** are the individual fields customers interact with - **Option Values** are the choices within multi-select options This structure lets you create a set of options once and apply them to many products. ## Option Groups Think of option groups as templates. Create a "Personalization" group with text input for engraving, then apply it to all products that offer engraving. Update the group once, and all assigned products reflect the change. Groups can apply to: - **All products** - Every product in your store shows these options - **Specific products** - Only selected products show these options ## Product Options Options are the actual form fields customers see. Each option has: - **Name** - Internal identifier for your reference - **Label** - What customers see on the storefront - **Type** - Dropdown, text input, checkbox, swatches, and more - **Values** - The available choices (for multi-select types) ## How Options Appear On your storefront, options display as form fields on product pages. Customers make their selections before adding to cart. Their choices appear in the cart, checkout, and order confirmation—making fulfillment straightforward. ## Customer Journey 1. Customer visits a product page 2. Custom options appear as form fields 3. Customer makes selections (fills text, picks colors, uploads files) 4. Options are validated (required fields must be filled) 5. Customer adds to cart with selections attached 6. Selections appear in cart and checkout 7. Order includes all customization details for fulfillment --- # Dashboard overview > Navigate the app and understand your metrics Source: https://help.pasilobus.com/product-options/dashboard-overview App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Getting started Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) The Product Options dashboard is your command center. At a glance, see how many options you've created, access your option groups, and navigate to settings. Use the sidebar to manage all aspects of your product customization. ## Dashboard Metrics The dashboard displays statistics about your Product Options setup: - **Option Groups** - Total groups you've created - **Product Options** - Total individual options across all groups - **Products** - How many products have options assigned ## Quick Actions From the dashboard, you can: - **Create Option Group** - Start building a new set of options - **View All Groups** - Browse and manage existing groups - **Access Settings** - Configure translations, appearance, and more ## Navigating the App The sidebar provides quick access to all sections: - **Dashboard** - Overview and metrics - **Option Groups** - Create and manage groups - **Galleries** - Manage file galleries for upload options - **Settings** - Configure storefront appearance, translations - **Plans** - View and upgrade your subscription ## Understanding Plan Features Your plan determines which features are available: - **Free** - Every option type, unlimited options and option sets, and conditional logic - **Pro** - Adds prices on options and quantity settings - **Max** - Adds cart and checkout wording, file galleries, and customer and market visibility Features locked by your plan appear with an upgrade prompt. You can still see and configure them, but they won't activate on your storefront until you upgrade. If you move to a smaller plan, your options and settings are kept, and the features it doesn't include stop on your storefront within a few minutes. --- # Option groups > Organize options into reusable groups Source: https://help.pasilobus.com/product-options/option-groups App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Option groups are containers that hold your product options. Instead of adding options to each product individually, you create a group once and assign it to products. This makes managing options across your catalog efficient and consistent. ## Why Use Option Groups Groups provide several benefits: - **Efficiency** - Create once, apply to many products - **Consistency** - All assigned products share the same options - **Easy updates** - Change the group, all products update - **Organization** - Keep related options together For example, create a "Gift Options" group with gift wrapping and a message field, then apply it to all giftable products. ## Creating an Option Group 1. Go to **Option Groups** in the app 2. Click **Create** (or **Create Option Group** from empty state) 3. Enter a group name 4. Choose your application scope 5. Click **Save** The group is created empty—you'll add options next. ## Application Scope Choose which products receive the group's options under **Apply to**: - **Specific products** - Only selected products show these options. Good for category-specific customization like engraving on jewelry or custom sizing on furniture. - **Products not in other groups** - A default group that covers any product not assigned to another option group. - **All products** - Every product in your store shows these options. Good for universal options like gift wrapping or rush shipping. - **Products in a collection / with a tag / of a type / by vendor** - Target products by an attribute they share, matched live and case-insensitively on the storefront. See the Product Targeting article for details. ## Managing Products For specific product targeting: 1. Open the option group 2. Click the **Products** link 3. Use the product picker to add products 4. Remove products by clicking the remove icon You can search and filter to find products quickly. ## Organizing Groups Keep your groups organized by using clear, descriptive names: - "Personalization Options" for engraving and monograms - "Gift Services" for wrapping and messages - "Rush Shipping" for expedited delivery options - "Custom Sizing" for made-to-order products This makes it easy to find and manage groups as your catalog grows. --- # Option types > Choose the right input type for each option Source: https://help.pasilobus.com/product-options/option-types App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-10 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Product Options supports over 20 option types organized into categories. Each type controls how customers interact with a particular customization field on your product page. ## Selection Options These types let customers choose from predefined values you create: - **Dropdown** - A collapsed list that expands when clicked. Best for many choices (5+) where you want to save space on the page. - **Radio Button** - All choices visible at once, customer picks one. Best for 2-4 important choices you want customers to see immediately. - **Checkbox** - Multiple checkboxes where customers can select one or more values. Best for add-ons like gift wrapping, insurance, or multiple toppings. You can limit how many choices customers pick — see Checkbox Selection Limits below. - **Swatches** - Visual selection using colors or images. Best for color options, patterns, or materials where seeing is important. - **Button** - Clickable buttons for each value. Best for sizes, styles, or any option where you want a clean, tappable selection. - **Image Dropdown** - A dropdown with image thumbnails next to each option. Best for showing visual previews while keeping a compact layout. - **Color Dropdown** - A dropdown with color swatches next to each option. Best for color selections where you want to combine a color preview with text labels. - **Product Collection** - A picker that lists every product from a Shopify collection with thumbnails and titles. Customers pick a product, then pick a variant from a cascading dropdown. The chosen variant becomes a priced add-on in the cart at its real price. Best for "build your own bundle" or "pick from this catalog" flows where you don't want to maintain option values manually. ## Checkbox Selection Limits Checkbox options can require a minimum number of selections, cap the maximum, or both. This is useful for offers like "pick exactly 3 toppings" or "choose up to 2 free samples". When editing a checkbox option, open **Field Settings** and set: - **Min Selections** - The fewest choices a customer must check. Leave blank for no minimum. - **Max Selections** - The most choices a customer can check. Leave blank for no maximum. On your storefront, the limits are enforced automatically: - **At the maximum** - Once a customer checks the maximum number of choices, the remaining unchecked choices are disabled. Unchecking one re-enables them. - **Below the minimum** - Add to cart is blocked and the customer sees a clear message, such as "Please select at least 2 options for 'Toppings'", shown both under the option and in the alert. - **Optional options stay optional** - The minimum applies once the customer checks at least one choice. If the option is not required and the customer leaves it untouched, they can still add to cart. When the option is required, the minimum always applies. ## Text & Input Options These types let customers enter their own values: - **Text Input** - Single-line text field. Best for short entries like names, initials, or short messages. - **Paragraph Text** - Multi-line text area. Best for longer entries like custom messages, special instructions, or dedications. - **Size (W × H)** - Two measurement fields priced by the area they describe. The customer types a width and a height, and the app charges your rate for each square unit. Best for anything cut to order: panels, glass, fabric, signage, rugs. - **Number** - Numeric input only. Best for quantities, dimensions, or other number-based entries. - **Email** - Validates email format. Best when you need a recipient's email address. - **Telephone** - Phone number input. Best for contact information or delivery coordination. ## Size Options A Size option asks for a width and a height and charges by the area. Under **Field Settings** you set only what is particular to a size: - **Unit** - What the customer measures in: inches, feet, centimetres or metres. - **Smallest and largest size allowed** - Optional bounds. A size outside them can't be added to the cart, and the customer is told why. The rate is the option value's price, set exactly the way every other option sets a price — so a Size option can be free, priced by hand, or priced from a product you already sell: - **Leave the price empty** - nothing is charged. The customer measures, the size travels with the order, and you know how big to make it. Good when the size affects the work but not the price. - **Type a price** - it is the price per square unit. At $4.00 with the unit set to feet, a 4 × 3 ft panel is $48.00. - **Assign a product** - the app takes the rate from that product, covered below. Customers see the maths before they add anything: **13 sq ft (rounded up from 12.6) × $4.00 = $52.00**. With no price they simply see **13 sq ft**. **Areas round up to the next whole unit.** A Shopify variant's price is fixed, so a part-unit charge has nowhere to live — the area is charged in whole units and the customer sees the rounding stated. Choose your unit with that in mind: pricing per square foot charges a 12.6 sq ft panel as 13, while pricing the same panel per square inch is exact to within a square inch but shows a large number of units in the cart. ## Pricing a Size From a Product You Sell If you already sell the material as a product, assign it to the option's value instead of typing a price. The app then takes the rate and the unit from Shopify, so you maintain them in one place and the cart line is your real product — with its own inventory, tax and reporting. This needs the product to be **priced per unit** in Shopify, using the unit price fields on the variant: - **Total amount** - how much is in the product you sell - **Base measure** - the unit you want it compared against The two must match for a Size option. A product whose total amount is 1 m² against a base measure of 1 m² *is* one square metre, so the app can sell thirteen of them as 13 m². A 5 m² roll shows the same "$27/m²" on your storefront but is a package: thirteen of those would be 65 m². The app refuses that one and tells you when you save. Square feet and square metres are the only area units Shopify supports here. Pricing per square inch or centimetre works, but only by typing the price. ## Advanced Options These types offer specialized input controls: - **Color Picker** - A full color picker with hex value output. Best for custom color selections beyond predefined swatches. - **Date** - Date picker calendar. Best for delivery dates, event dates, or scheduling. - **Date & Time** - Date and time picker. Best when you need both a date and a specific time (e.g., pickup time). - **Switch / Toggle** - An on/off toggle switch. Best for simple yes/no choices like "Add gift wrap?" or "Include batteries?". - **Range Slider** - A slider that customers drag to select a value within a range. Best for dimensions, intensity levels, or any numeric range. - **File Upload** - Lets customers attach files. Best for custom artwork, photos for printing, or documents. - **File Upload with a gallery** - A File Upload option can carry a gallery of images you uploaded in advance, so the customer either picks one of yours or uploads their own — and the two can be priced differently. Galleries require the Max plan. See the Image Galleries article. ## Display Only Options These types don't collect customer input — they help organize and format your option form: - **Heading** - Adds a section heading to visually separate groups of options. - **Paragraph** - Adds descriptive text or instructions between options. - **Divider** - Adds a horizontal line to visually separate sections. - **Spacing** - Adds vertical space between options. - **HTML Content** - Renders custom HTML content within the option form. ## Other - **Hidden** - Not visible to customers but included in orders. Best for internal tracking, metadata, or values set by conditional logic. ## Choosing the Right Type - **Number of choices** - Few options? Use radio buttons or buttons. Many options? Use dropdown. - **Visual importance** - Need to show colors/patterns? Use swatches. Need image previews? Use image gallery or image dropdown. - **Free-form input** - Customer provides text? Use text input types. - **Validation needs** - Need specific formats? Use email, telephone, or number. - **File requirements** - Customer uploads their own file? Use file upload. Customer picks from your images? Use image gallery. - **Simple yes/no** - Use switch/toggle or checkbox. --- # Product collection option > Let customers pick a product (and variant) from a Shopify collection as an option Source: https://help.pasilobus.com/product-options/product-collection App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-07-13 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) The Product Collection option type lets customers pick any product from a Shopify collection as a customization choice — without you having to maintain option values manually. The collection's products and variants are pulled automatically, so when you add or remove products from the collection, the option updates with the next sync. This is ideal for "pick a complementary product" or "build your own bundle" flows. ## When to use it Use Product Collection instead of a regular Dropdown when: - The list of choices is long enough that maintaining option values by hand is painful - The choices are real Shopify products and you want to use their actual prices, inventory, and variants - You want customers to see a product image and title for each choice instead of just text - The selection should appear in the cart as a real product line item, not a custom property ## Setting it up When creating or editing an option, choose **Product Collection** as the type. The values editor disappears and a single setting appears: - **Source collection** - click **Select collection** and pick the Shopify collection whose products should populate the picker. The picker uses the standard Shopify resource picker. - **Hide out-of-stock products** - when on, products whose variants are all unavailable are filtered out of the picker entirely. When off (default), unavailable products show grayed out and can't be selected. That's it. There are no manual option values, no per-value images, and no pricing fields. Prices come from each variant directly. ## How it looks on the storefront Customers see a styled dropdown showing each product's thumbnail and title. Clicking opens a scrollable list of all products in the collection. After picking a product: - If the product has one variant, it's auto-selected and the variant dropdown is hidden - If the product has multiple variants (size, color, panel count, etc.), a second native dropdown appears for variant selection — pre-filled with the first available variant. Customer can change it. The selected variant is treated as a priced add-on, exactly like any other priced option. ## Cart behavior When the customer adds to cart, the selected variant becomes a separate line item — same as a Dropdown option with a priced value. All other configuration options on the page apply as line-item properties. If you've enabled **Merge into main product** on the option, the variant line item is bundled with the main product in cart via the Cart Transform Function, so customers see one merged line. The variant's price, inventory, and tax behavior come from Shopify directly — there's no separate pricing setup in the app. ## How it stays in sync Collection contents change automatically. The product list refreshes when: - A product's price, title, image, or inventory changes (via the existing `products/update` webhook) - The collection's product membership changes (via the `collections/update` webhook) You don't need to manually re-save the option after changing products in the collection. ## Limitations - The picker fetches up to 250 products at a time. Collections larger than that will only show the first 250 — consider splitting into smaller curated collections. - Each product can have up to 100 variants in the picker. - Conditional logic that triggers on this option treats the variant title as the value (e.g., "Hat – Small"). --- # Option values & pricing > Set up choices and additional pricing Source: https://help.pasilobus.com/product-options/option-values App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-10 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Option values are the choices within selection-type options. Each value can have its own price, image, and linked product. Setting up values correctly ensures customers see the right choices and pricing. ## Adding Option Values For dropdown, radio button, checkbox, and swatch options: 1. Create or edit an option 2. In the **Option Values** section, click **Add value** 3. Enter the value name (what customers see) 4. Repeat for all choices Values appear in the order you add them. Drag to reorder if needed. ## Setting Prices Every value has a **Price** field that is always editable. To charge extra for a value, simply type the amount: 1. In the **Pricing Settings** section, find the value 2. Type the add-on amount in the **Price** field (for example, 5.00) 3. Click **Save** The app handles the rest automatically: - **Add-on variant created for you** - The app creates a purchasable variant on a hidden, app-managed product called "Add-ons" and assigns it to the value. The variant is titled after your value (for example, "Gift Wrap (+$5.00)") and uses the value's image, so customers see a presentable line in cart, checkout, and on their order — never an internal product name. - **Edits update in place** - Change the price later and the app updates that same variant's price and title. No duplicate variants accumulate over time. - **Type 0 to remove a price** - Entering 0 clears the price and detaches the assigned variant from the value. After saving, you stay on the option form and a confirmation toast appears. The price displays next to the value name on the storefront, and when a customer selects the value, the add-on is charged automatically at checkout. **Note:** Pricing features require the Pro plan or higher. ## Using Your Own Products Instead of typing a price, you can link a value to a product or variant that already exists in your catalog: 1. Click **Select price** for the value 2. Use the product picker to find and select a product 3. Choose the specific variant if applicable 4. The product's price and image are linked to the value This is useful when the add-on is a real product you also sell on its own, or when you want the value's price to stay in sync with your catalog. **Editing the price of a linked product:** If you type a new amount in the **Price** field of a value that uses one of your own variants, the app updates that variant's price in your Shopify catalog — the change applies everywhere that variant is sold. Before applying it, an inline warning shows how many other option values share the same variant. Click **Update** to confirm the change, or **Cancel** to keep the current price. ## Value Images Any value can carry an image, not just swatches. Click the dashed image square on the value and pick a file from your computer. Square images work best; the storefront crops to a square and shows them at 75 pixels by default. Where the image appears depends on the option: - **Swatches and colour or image dropdowns** - the image *is* the choice, shown in the picker itself - **Checkbox and radio lists** - one image per row, at the right-hand edge of the option - **Buttons** - no image; a button is already the thing being chosen, so a picture on it turns a row of buttons into something else - **Everything else** - a single image in a column beside the option, which swaps as the customer changes their selection In every case the image sits on the same line down the page, so a product page with several options reads as one column of choices and one column of pictures rather than pictures scattered at different widths. ## Showing Value Images on the Storefront **Show the value's image** in the **What customers see** section controls whether those images reach the storefront. It is **on by default** — most stores that upload an image want it seen — and the row only appears once at least one value on the option has an image, since there is nothing to decide before that. Turn it off when the image is for your reference rather than the customer's, or when the picker already shows it and a second copy beside the option is redundant. An option whose selected value has no image shows nothing and gives the space back to the field, so leaving it on costs nothing. On a **File Upload** option this setting is worded differently — *Show the image you added* — because it governs the picture you attached to the value, not the customer's file. Their upload always previews, whatever this is set to. ## Default Value Selection Pre-select a value for customers: 1. Scroll to **Default Selection** in the option form 2. Choose which value should be pre-selected 3. Customers can still change their selection Leave empty to require customers to make an active choice. ## Prices That Follow a Measurement If a value charges through one of your own products, and that product is priced per unit in Shopify, the option says so too. A value linked to acrylic sold at $27 per square metre shows **+$27.00/m²** on the storefront rather than a bare **+$27.00** — in the option, in the cart and everywhere else the price appears. Nothing to set up here: it comes from the unit price fields on the variant, so it is yours to change in Shopify and it disappears from the option if you turn it off there. This is the same information EU, UK and German price-indication rules require you to show on goods sold by weight, volume, length or area. ## Hiding Prices If you don't want customers to see additional charges: 1. In **Pricing Settings**, enable **Hide Prices from Customers** 2. Prices still apply at checkout, but aren't displayed on product pages This is useful for psychological pricing or when price differences might discourage selection. --- # Quantity settings > Control how option quantities work Source: https://help.pasilobus.com/product-options/quantity-settings App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-03-19 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Add-ons are charged for every item ordered. A $10 product with a $5 add-on costs $15 each, so a shopper who buys 2 pays $30. The product page, the cart and checkout always show the same total. ## Quantity Settings By default an add-on goes with each item and no extra field is shown. Turn on **Enable quantity** on an option to change how many of the add-on go with each item: - **Customer chooses how many** - A quantity picker appears with the option. A shopper who picks 3 gets 3 of the add-on with each item, so 2 items with 3 add-ons each is 6 add-ons. - **Match the product's quantity** - One add-on per item, with no field shown. This is the same as leaving quantity off. - **A fixed number** - The same number of add-ons with each item, for example 4 buttons per shirt. No field is shown. ## Splitting the Quantity Across Options With **Customer chooses how many**, you can turn on **Counts toward the product quantity**. The pickers on those options then share out the order rather than multiplying it: 150 black and 100 red for an order of 250. Add to cart waits until they add up, and each add-on is charged for the number picked. ## Configuring Quantity 1. Edit an option 2. Find the **Quantity** card 3. Turn on **Enable quantity** and choose a mode 4. For a fixed number, enter it 5. Save the option **Note:** Quantity settings and prices on options require the Pro plan or higher. ## Show the Picker on Values That Cost Nothing With **Match the product's quantity** or **A fixed number**, you can choose whether the quantity picker shows on values that cost nothing. This is useful when you need the quantity for fulfillment even without a charge. --- # Conditional logic > Show or hide options based on other selections Source: https://help.pasilobus.com/product-options/conditional-logic App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-03-19 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Conditional logic shows or hides options based on other selections. Create dynamic forms that adapt to customer choices — showing relevant options while hiding irrelevant ones for a cleaner, more intuitive experience. ## What is Conditional Display Conditional display lets you set rules like: - Show "Engraving Text" only when "Add Engraving" is checked - Show "Gift Message" only when "Gift Wrap" is selected - Show specific size options only for certain colors - Show a date picker only when "Schedule Delivery" is toggled on This keeps your forms focused and avoids overwhelming customers with irrelevant fields. ## Setting Up Conditions 1. Edit the option you want to conditionally show or hide 2. Scroll to **Conditional Display** and toggle **Add Conditions** 3. Click **Add Condition** 4. Select which option the condition depends on 5. Choose the operator 6. Enter or select the value to match (if applicable) 7. Set the **Visibility Action** — whether conditions should show or hide the option 8. Save ## Condition Types Conditions can be based on two sources: - **Other Option** - Trigger based on what a customer selects in another option within the same group - **Shopify Variant** - Trigger based on the selected Shopify product variant (e.g., show different options depending on the Size or Color variant) ## Condition Operators - **Is equal to** - Matches when the other option's value exactly equals your specified value - **Is not equal to** - Matches when the value does NOT equal your specified value - **Is filled** - Matches when the customer has entered any value (not empty) - **Is empty** - Matches when no value has been entered - **Is checked** - Matches when a checkbox or toggle is turned on - **Is unchecked** - Matches when a checkbox or toggle is turned off - **Is in list** - Matches when the value is one of several comma-separated values ## Visibility Action Choose what happens when conditions are met: - **Show when conditions are met** - The option starts hidden and appears only when the condition is satisfied - **Hide when conditions are met** - The option starts visible and disappears when the condition is satisfied ## Multiple Conditions Add multiple conditions and choose how they combine: - **All conditions must be met (AND)** - Every condition must be true for the action to trigger - **At least one condition must be met (OR)** - Any single condition being true triggers the action ## Example Workflows **Engraving Options:** 1. Switch: "Add Engraving?" 2. Text Input: "Engraving Text" — shows when "Add Engraving" is checked 3. Dropdown: "Font Style" — shows when "Add Engraving" is checked **Gift Services:** 1. Checkbox: "This is a gift" 2. Dropdown: "Gift Wrap Style" — shows when "This is a gift" is checked 3. Paragraph Text: "Gift Message" — shows when "This is a gift" is checked **Variant-Based Options:** 1. When Shopify variant "Size" equals "Custom" → show "Custom Width" and "Custom Height" number fields ## Preview The option group preview in the sidebar reflects conditional logic in real time. When you interact with options in the preview, dependent options appear and disappear just as they would on your storefront. ## Plan Requirements Conditional logic is included on every plan, Free included. --- # Cart & checkout display > Configure how options appear in cart and checkout Source: https://help.pasilobus.com/product-options/cart-checkout-display App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-03-19 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Cart and checkout display settings control how customer selections appear after they add to cart. By default, all option selections are shown as line item properties in cart and checkout. You can customize this behavior per option. ## How It Works By default, when a customer selects an option value (e.g., picks "Red" for a Color option), that selection appears in the cart and checkout as a line item property like "Color: Red". This helps customers verify their choices and helps your team fulfill orders accurately. The selection appears in: - Shopping cart - Checkout page - Order confirmation email - Order details in Shopify admin ## Hiding Selections from Cart & Checkout If you don't want a particular option's value to appear in cart and checkout: 1. Edit the option 2. Open **Cart & Checkout** and toggle **Customize** 3. Check **Hide in cart & checkout** 4. Save the option This is useful for options that are purely visual (like dividers or headings) or for internal-use options where the selected value isn't meaningful to the customer. ## Custom Display Labels Change how option names appear in cart and checkout: 1. Edit an option 2. Open **Cart & Checkout** and toggle **Customize** 3. Enter a label in **Cart/checkout label** 4. Leave empty to use the option name Examples: - Option name "engraving_text" → Cart label "Engraving" - Option name "wrap_style" → Cart label "Gift Wrap" This creates cleaner, customer-friendly display without changing your internal naming. ## Merge to Product For priced options, choose whether they appear as separate line items or merge into the main product: - **Enabled (default, recommended)** - Priced options merge into the main product. Customers see one line with the combined price and the choices they made, and can't remove a paid add-on on its own. Removing the line removes the product and its add-ons together. - **Disabled** - Priced options appear as separate cart lines. Customers see the main product plus each add-on with its own price. With the checkout rule on (see below), a customer who removes the product but leaves its add-on is asked to remove the add-on before paying. Merging is done by the app's cart transform, which the app switches on for your store by itself when you open it. To change it for an option, edit the option and use **Keep add-ons on the product's cart line** in the Display section. It's available on every plan. ## Checkout Rule for Required Options Required options are checked on the product page. A customer can still skip them by adding the product another way, for example a quick add button on a collection page or an add-to-cart link. The checkout rule closes that gap: at checkout, it stops the order and asks the customer to choose the options on the product's page. It applies to products you assigned to an option set yourself, when every option set on that product has a required option that's always shown. It also stops checkout when a paid add-on is left in the cart without its product. To turn it on, go to **Settings > Checkout** in Shopify, find **Checkout rules**, add **Product Options required choices** and turn it on. The **Extensions** page in the app links there. ## Plan Requirements Hiding options and renaming them for the cart and checkout needs the Max plan. Merging add-ons into the product line and the checkout rule are on every plan. --- # Image galleries > Let customers choose from pre-uploaded images Source: https://help.pasilobus.com/product-options/file-galleries App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-10 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Image galleries let customers choose from images you've uploaded in advance. Instead of asking customers to upload their own files, you provide a curated set of images they can browse and select — perfect for clip art, monogram styles, design templates, or pattern selections. ## How Image Galleries Work A gallery is a collection of images you manage in the app. You attach one to a **File Upload** option, and the shopper gets two buttons side by side: one to pick from your gallery, one to upload a file of their own. You can price the two differently — a gallery design included, their own artwork for a setup fee, for instance. So a gallery isn't a separate option type. It's a setting on a File Upload option, which is what lets a shopper choose *your* image or *their* image in the same field. ## Managing Galleries Galleries are managed from **Settings > Galleries**: 1. Go to **Settings** in the app sidebar 2. Click **Galleries** 3. Click **Create Gallery** and give it a name 4. Upload images by dragging or clicking to select 5. Optionally add tags to images for filtering You can add, remove, or replace images at any time. Changes are reflected immediately on your storefront. ## Organizing with Tags Add tags to gallery images for filtering: - Click an image in the gallery - Add one or more tags (e.g., "sports", "floral", "holiday") - When attaching a gallery to an option, enter tags in the **Filter by Tags** field to show only matching images This lets you reuse one large gallery across multiple options, showing only the relevant images for each. ## Attaching a Gallery to an Option 1. Create or edit an option and choose **File Upload** as the type 2. In the **File gallery** card, turn **Enable** on 3. Select the gallery to use 4. Optionally enter tags to show only part of it 5. Choose whether gallery picks should add cost 6. Save the option On the product page the shopper sees your gallery button beside the upload button, and the picture they choose carries through to the cart and the order. ## Gallery Pricing - **With pricing** - a gallery pick can add to the price, like any other option - **No additional price** - check "No Additional Price for Gallery Images" so picking from your gallery is free even when uploading their own file is not. This is the usual setup: your designs included, their artwork charged. ## Plan Requirements Image galleries require the Max plan. --- # Product targeting > Control which products show your options Source: https://help.pasilobus.com/product-options/product-targeting App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Product targeting controls which products display your option groups. Apply options to your entire catalog or select specific products—giving you flexibility in how customization is offered across your store. ## Application Scope When creating or editing an option group, choose a scope under **Apply to**: - **Specific products** - Only products you select show these options - **Products not in other groups** - A default group that applies to any product not covered by another option group - **All products** - Every product in your store shows these options - **Products in a collection** - Products in a Shopify collection you choose - **Products with a tag** - Products carrying a tag you enter - **Products of a type** - Products matching a product type you enter - **Products by vendor** - Products from a vendor you enter ## Apply to All Products Use this when options should appear universally: - Gift wrapping available on everything - Rush shipping for all orders - Terms acceptance checkbox All products automatically include the group's options. New products added to your store will also show these options. ## Specific Product Selection Use this when options only apply to certain products: - Engraving on jewelry only - Custom sizing on furniture - Personalization on gifts You manually select which products receive the options. ## Targeting by Collection, Tag, Type, or Vendor Instead of picking products one by one, target them by an attribute they already share: - **Products in a collection** - Click **Select collection** and pick a collection with the collection picker. Every product in that collection shows the group's options. - **Products with a tag** - Enter a tag in the **Tag** field. Any product carrying that tag matches. - **Products of a type** - Enter a product type in the **Product type** field. - **Products by vendor** - Enter a vendor name in the **Vendor** field. Matching happens live on the storefront against the product being viewed, and it's case-insensitive — "Gifts" matches "gifts". If you add a tag to a product, change its type or vendor, or add it to the targeted collection, it starts showing the options immediately. No re-sync is needed, and removing the attribute stops the options just as quickly. The option groups list shows the chosen criterion in the scope column (for example, the collection name or the tag), so you can see each group's targeting at a glance. When you export option groups, the targeting settings are included, and importing restores them. ## Using the Product Picker For specific product targeting: 1. Open the option group 2. Click the **Products** link (or the product count) 3. Click **Add Products** 4. Search or browse to find products 5. Select products to add 6. Click **Add** to confirm Products immediately start showing the group's options. ## Removing Products To remove a product from an option group: 1. Open the option group's products list 2. Find the product to remove 3. Click the remove icon 4. Confirm removal The product no longer shows those options. ## Best Practices - **Start specific, expand later** - It's easier to add products than remove them. Start with specific targeting and expand if needed. - **Use collections, tags, types, or vendors** - If your catalog is already organized in Shopify, target by that attribute instead of picking products manually. New products that match are covered automatically. - **Combine groups** - A product can belong to multiple option groups. A jewelry item might have both "Engraving" and "Gift Services" groups. --- # Translations > Customize text and support multiple languages Source: https://help.pasilobus.com/product-options/translations App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-10 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Every store has its own voice. Whether you're localizing for international customers or simply prefer different terminology, translations let you customize every text string to match your brand and audience. ## Accessing Translations 1. Go to **Settings** in the app 2. Click **Translations** 3. Select your language from the dropdown 4. Edit any text strings 5. Click **Save** Changes apply immediately to your storefront. ## Supported Languages Product Options includes translations for: - English (default) - Spanish - French - German - Italian - Portuguese - Dutch - Japanese - Korean - Chinese (Simplified & Traditional) - And many more... Your store's primary language is detected automatically from Shopify settings. ## Custom Text Overrides Even without multiple languages, you can customize text: 1. Select your primary language in translations 2. Find the string you want to change 3. Enter your custom text 4. Save Examples: - Change "Required" to "Must fill in" - Change "Select an option" to "Choose one" - Change "Add to Cart" to "Buy Now" ## Common Strings to Customize - **Form labels** - "Required", "Optional" - **Validation messages** - "Please select an option", "This field is required" - **Button text** - Any add-to-cart or action button labels - **Placeholder text** - Default text shown in empty fields ## Multi-Language Stores For stores serving multiple regions: 1. Add each language in Shopify's language settings 2. Customize translations for each language in the app 3. Customers see translations based on their language selection The app respects Shopify's language detection and serves the appropriate translations. --- # Custom CSS > Style option elements with CSS Source: https://help.pasilobus.com/product-options/custom-css App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Product Options inherits your theme's fonts and colours automatically, and its own look is driven by the block's settings. When you need more than those settings offer, CSS gives you the rest. ## Where to Put Your CSS Shopify's theme editor has a **Custom CSS** box on every section, and one for the theme as a whole. Open the theme editor, select the section holding the Product Options block — or the theme, under **Theme settings** — and paste your rules there. They apply to the storefront without touching theme code, and they survive theme updates. Anything you write there is scoped by Shopify to that section, so the selectors below are all you need. ## Settings First Most of what merchants reach for CSS to change is a block setting, and a setting survives an app update where a selector may not. In the theme editor, click the Product Options block and you will find **Field background**, **Field hover background**, **Field max width**, **Field border width**, **Field border colour**, **Field corner radius**, **Dropdown chevron size** and **Value image size**. Those drive the app's own styling — the CSS below is for what they don't cover. ## Common Styling Examples **Change label colour:** ```css .product-options-wrapper .form__label { color: #333333; font-weight: bold; } ``` **Style the dropdown:** ```css select.product-option { border: 2px solid #000000; border-radius: 8px; } ``` **Change the value image size:** ```css .product-options-wrapper { --po-image-size: 100px; } ``` **Change the spacing between an option's parts:** ```css .product-options-wrapper { --po-gap: 14px; } ``` **Style the help text under an option:** ```css .product-options-inner-wrapper .description { font-size: 13px; opacity: 1; } ``` ## CSS Variables These are the supported way to restyle the block, and are what the block settings themselves set. Declare them on `.product-options-wrapper` and everything inside picks them up: - `--po-image-size` - How big value images are (default 75px) - `--po-gap` - The spacing step used between an option's parts and between the rows of a list (default 10px) - `--field-max-width` - How wide a field is allowed to get (default 360px) - `--field-height` - Minimum field height, shared by inputs, dropdowns and the quantity stepper (default 45px) - `--field-bg` / `--field-hover-bg` - Field background, at rest and on hover - `--field-border-width` / `--field-border-color` / `--field-border-radius` - The field border - `--field-chevron-size` - The dropdown caret ## CSS Class Reference **Containers:** - `.product-options-wrapper` - The whole block; where the variables above are declared - `.product-options-inner-wrapper` - One option - `.po-option-content` - Everything the customer reads and acts on within an option - `.po-option-control` - An option's label and its field - `.po-option-media` - The image column beside an option - `.po-option-qty` - The quantity picker beside a field **Fields:** - `.product-option` - On every option's field or field wrapper, whatever the type - `select.product-option` - Dropdowns - `.field__input.normalized` - Text, email, phone, number and date inputs - `.product-option .checkbox` / `.checkbox-item` - Checkbox lists and their rows - `.product-option.radio-buttons` - Radio lists - `.button-option` - Button tiles - `.product-option__pick-file-btn` / `.product-option__pick-upload-btn` - The gallery and upload buttons **Values:** - `.po-value-main` - A row's checkbox or radio and its label - `.po-value-media` - A row's image cell - `.po-value-image` - The image itself - `.po-value-description` - Per-choice description text **Accordion layout:** - `.accordion-item` - One collapsible option - `.accordion-button` - The header; gains `.active` when open, `.completed` when confirmed, `.skipped` when skipped - `.selected-value` - The chosen value shown in the header - `.accordion-content` - The panel ## Theme-Specific Adjustments The app already declines your theme's field decoration — Dawn and its descendants draw a border on the `.field` and `.select` wrappers, which would sit outside the app's own border — so a double outline is not something you need CSS for. For anything else, inspect the element in your browser and target the classes above. They are stable; if you find yourself needing a selector that isn't listed here, tell support rather than relying on one you found by inspection. --- # Orders & CSV export > Review orders with customizations and export them to a spreadsheet Source: https://help.pasilobus.com/product-options/orders-export App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Features Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Every order that includes a product customization is collected in one place so you can see exactly what each customer asked for — and export it all to a spreadsheet. This is especially useful for production and fulfillment, where you need each option value broken out into its own column rather than buried in a line-item note. ## The Orders Page Open **Orders** from the app navigation. Only orders that contain product option customizations appear here — plain orders without options are left out to keep the list focused. An order appears as soon as it's placed, including orders waiting for a manual payment capture. Revenue figures count it once it's paid. ## Choices on Shopify's Order Page You can also see each item's choices without leaving Shopify's own order page. Open any order, select the apps icon above the order's cards and pin **Product options**. The card lists what the customer chose on every item, and uploaded files open from their links. It shows on every order from then on. For each order you'll see: - **Order** - The Shopify order number, linked to its details - **Customer** - Who placed the order - **Customizations** - How many option values were captured on that order - **Date** - When the order was placed - **Total** - Order value for the customized items Use the search box to find an order by number or by a customization value. ## Exporting to CSV The Orders page has an **Export** action in the top bar. It opens a dedicated export page that shows how many orders and line items are included, then a **Download CSV** button starts the download. The file downloads directly to your computer, ready to open in Excel, Google Sheets, or Numbers. ## What's in the File The export uses a **one row per ordered item** layout, which is what makes it useful for production sheets: - Each customized product in each order becomes its own row - Standard columns come first: order number, date, customer, shipping address, product, variant, SKU, quantity, and item price - **Every option becomes its own column** - the option name is the column header and the customer's choice is the value So if a customer ordered an engraved bracelet, you'll see the engraving text, font, and any other options each in their own column, right next to the product and shipping details. ## Shipping Address Columns The export includes the shipping address for each order, split into separate columns for easy sorting and mail-merge: - **Ship name**, **Address 1**, **Address 2**, **City**, **Province**, **Zip**, **Country**, **Phone** Because address is order-level, every line-item row from the same order repeats that order's address. Orders placed before address capture was added may have blank address fields; new orders always include it. ## Why Not Just Use Shopify's Export Shopify's built-in order export keeps line-item customizations as a single combined properties field, which is hard to read and impossible to sort or filter by a specific option. This export breaks each option out into its own column, so you can filter by font, sort by size, or hand a clean production sheet to your team. ## Common Uses - **Production sheets** - Give your workshop a clear list of what to make, with every customization spelled out - **Fulfillment** - Pack and ship with the shipping address and options side by side - **Backups and analysis** - Keep a snapshot of customization data or analyze which options sell --- # Shopify Flow > Automate work on orders with customizations and uploads Source: https://help.pasilobus.com/product-options/shopify-flow App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Integrations Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Shopify Flow runs work for you when something happens in your store. Product Options gives Flow two triggers and one action, so orders with customizations can be tagged, routed to your production team or approved without opening the app. ## Triggers - **Order with product options** - Starts when a paid order includes at least one customization. It gives the workflow the order itself, plus the order name, the customer's email, how many customizations were chosen and the value of the customized items. - **Order has uploads** - Starts when a paid order includes files the customer uploaded, such as artwork or a photo. It gives the workflow the order, the number of files and a link to each one. Each trigger runs once per order, when the order is paid. Orders placed with a manual payment capture start the workflow when you capture the payment. ## Tagging Orders Both triggers hand the workflow the order, so Flow's own actions work on it. For example, to tag every order that has artwork: 1. In Shopify Flow, create a workflow and choose the **Order has uploads** trigger 2. Add the **Add order tags** action and enter a tag such as `artwork` 3. Turn the workflow on You can use the same order in conditions (for example, only orders shipping to one country) and in other actions, such as sending an internal email with the file links. ## Approving Customizations The **Approve product option customizations** action marks every customized item on an order as approved in Product Options, the same as approving each item on the app's order page. Use it at the end of a workflow, for example once a proof has been checked elsewhere. ## Plan Requirements The triggers and the action work on every plan. --- # Theme integration > Manual integration for custom themes Source: https://help.pasilobus.com/product-options/theme-integration App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: For developers Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) For most stores, the theme setup wizard handles everything. This guide is for developers building custom themes or needing manual control over option placement and behavior. ## App Embed vs App Block Product Options uses two integration methods: - **App Embed** - A global script that loads on every page. Handles form submission, validation, and cart integration. Enable in: Theme Editor > App embeds > Product Options - **App Block** - Placed on product pages to render the options form. Add in: Theme Editor > Add block > Apps > Product Options Both must be enabled for full functionality. ## Manual Block Placement For custom product templates: 1. Open your theme code 2. Navigate to the product template (e.g., `sections/main-product.liquid`) 3. Ensure the template supports app blocks in the product form area 4. The block will be available for placement via the theme editor For vintage themes without app block support, contact support for manual integration code. ## Block Settings Click the placed block in the theme editor to configure it. **Layout** - **Form Elements** - every option rendered one after another, the way a normal form reads - **Accordion Collapsible** - each option is a collapsible row showing the chosen value in its header, with **Add to Product** and **Skip** buttons in the panel. Skipping clears whatever was entered in that option, so a skipped option carries no value and no charge. **Value image size** - how big value images are, from 40 to 240 pixels. Everything else positions itself from this, so images stay aligned whatever you choose. **Title and Description** - optional text above the options. **Colours** - accent (used for the selected state), border, card background, and the completed and skipped colours for accordion rows. **Form Fields** - background, hover background, max width, border width, border colour, corner radius and dropdown chevron size. These apply to every field type at once: native dropdowns, text inputs, the colour and image dropdowns, the quantity picker, and the file-upload buttons. **Button Text** - the wording of the accordion's Add and Skip buttons, and the title of the additional-options group. **Layout & Spacing** - block border width, the gap below each option, and padding around the block. **After Adding to Cart** - stay on the page, go to the cart, or go straight to checkout. ## Form Integration Product Options integrates with the product form automatically. When customers submit the form: 1. Options are validated (required fields checked) 2. Selections are added to cart as line item properties 3. Priced options add additional line items or modify the product price The app handles this integration through the app embed script. ## Customizing Option Display For advanced styling beyond Custom CSS: 1. Identify the option's HTML structure using browser dev tools 2. Target elements with your theme's CSS 3. Use the CSS class reference from the Custom CSS article Remember that the app generates HTML dynamically—avoid overly specific selectors that might break with updates. ## Cart and Checkout Selected options appear in cart and checkout as line item properties. The property format is: ``` property_name: selected_value ``` Your theme's cart template should display line item properties. Most modern themes do this automatically. If not, add to your cart template: ```liquid {% for property in item.properties %} {% unless property.last == blank %}
{{ property.first }}: {{ property.last }}
{% endunless %} {% endfor %} ``` --- # Options not showing > Fix invisible product options Source: https://help.pasilobus.com/product-options/options-not-showing App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Troubleshooting Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) If your product options aren't appearing on product pages, don't worry—it's usually a quick fix. Most issues come down to the app embed being disabled, the block not being added, or products not being assigned to an option group. ## Check the App Embed The most common cause is the app embed being disabled: 1. Go to **Online Store > Themes** 2. Click **Customize** on your active theme 3. Click **App embeds** in the left sidebar 4. Look for **Product Options** 5. Make sure the toggle is **ON** 6. Click **Save** If Product Options doesn't appear in app embeds, try reinstalling the app. ## Verify Block Placement Even with the embed enabled, you need the app block on product pages: 1. In theme editor, select **Products > Default product** from the page dropdown 2. Look for the **Product Options** block in the product section 3. If missing, click **Add block > Apps > Product Options** 4. Position it where you want options to appear, above **Add to cart**. On Dawn and some other themes the setup button adds it at the bottom of the product section, below Add to cart and Share: drag it up above the buy buttons 5. Click **Save** ## Check Product Targeting Options only appear on products assigned to an option group: 1. Open your option group in the app 2. Check the application scope: - If "All products" — options should appear everywhere - If "Specific products" — verify the product is in the list - If targeting a collection, tag, product type, or vendor — verify the product actually has that attribute (matching is case-insensitive, but the value must otherwise match, e.g. "t-shirt" won't match a "tshirt" type) 3. Add the product (or the matching tag/type/vendor/collection membership) if it's missing ## Verify Options Exist An empty option group won't display anything: 1. Open the option group 2. Confirm it has at least one option 3. Check that options aren't all set to "Hidden" type 4. Ensure no conditions are hiding all options ## Theme Compatibility Some themes may need adjustments: - **Outdated themes** - May not support app blocks. Update to the latest version. - **Custom themes** - Verify the theme uses Online Store 2.0 features and includes app block zones in product templates. - **Third-party themes** - Check theme documentation for app compatibility. ## Cache Clearing Browser or CDN cache can show old versions: - **Browser cache** - Press Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac) - **Shopify cache** - Make a small edit in theme code, save, then revert - **CDN cache** - Purge cache in your CDN dashboard if using one ## Still Not Working? If options still don't show: 1. Check browser console for JavaScript errors 2. Disable other apps temporarily to test for conflicts 3. Try a different browser or incognito mode 4. Contact our support with your store URL --- # Pricing issues > Fix option pricing problems Source: https://help.pasilobus.com/product-options/pricing-issues App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Troubleshooting Last updated: 2026-08-09 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) If option prices aren't displaying correctly or calculations seem wrong, there are several things to check. Most pricing issues relate to plan requirements, configuration, or how prices are attached to values. ## Prices Not Appearing If prices don't show next to option values: 1. **Check your plan** - Pricing features require the Pro plan or higher. Free plan users see options but cannot add prices. 2. **Verify prices are set** - Edit the option and check that each value's **Price** field is filled in under **Pricing Settings**. A price of 0 means no charge — entering 0 clears the price and detaches any assigned variant. 3. **Check "Hide Prices" setting** - If enabled, prices won't display to customers (but still apply at checkout). 4. **Confirm option type** - Single-value types like text input don't show prices the same way as dropdown or swatches. ## Incorrect Price Calculations If the total seems wrong: 1. **Add-ons count per item** - An add-on is charged for every item ordered. A $10 product with a $5 add-on costs $15 each, so 2 of them cost $30. The product page, the cart and checkout all show the same total. 2. **Review attached products** - If a value is linked to one of your own products, it charges that variant's current catalog price — check the product in your Shopify admin. Values where you typed a price use an app-managed add-on variant that always matches the amount you entered. 3. **Multiple priced options** - Prices are additive. If selecting multiple options with prices, all are added together. ## "Something Went Wrong" When Adding a Priced Choice Prices you type on a value are charged through a hidden **Add-ons** product the app creates in your store. It has to be on the Online Store sales channel, or the cart refuses it. The app publishes it by itself and checks again each time you save an option, so saving any option fixes it. If it still happens, open **Products**, find **Add-ons** (product type Pasilobus Product Options), and include it in the **Online Store** sales channel. Keep its status Unlisted so it stays out of your collections and search. ## Prices Not Applying at Checkout If prices show on the product page but don't apply: 1. **Verify the selection** - Ensure the customer actually selected the priced option, not just viewed it. 2. **Check merge settings** - If "Merge to Product" is enabled, the price adds to the main product rather than appearing as a separate line. 3. **Conditional options** - If the priced option uses conditional display, ensure conditions were met when added to cart. ## Currency Display Issues If prices show in the wrong format: 1. **Check Shopify currency settings** - The app uses your store's currency configuration. 2. **Multi-currency stores** - Prices convert based on Shopify's currency conversion rates. ## Plan Upgrade If pricing features aren't working, you may need to upgrade: 1. Go to **Plans** in the app 2. Select Pro or higher 3. Pricing features activate immediately after upgrade --- # Styling issues > Fix appearance problems Source: https://help.pasilobus.com/product-options/styling-issues App: Product Options (on the Shopify App Store as "Pasilobus Product Options") Shopify App Store: https://apps.shopify.com/product-options-pasilobus App help: https://help.pasilobus.com/product-options Section: Troubleshooting Last updated: 2026-08-10 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) If Product Options doesn't look right on your store — wrong colours, sizes, or alignment — start with the block's own settings. Most of what looks wrong is something the app is meant to control for you. ## Start With the Block Settings Open the theme editor and click the Product Options block. Under **Form Fields** you can set the field background, hover background, max width, border width, border colour, corner radius and dropdown chevron size; **Value image size** sets how big value images are. These drive every field type at once — a dropdown, a text input, the quantity picker and the file-upload buttons all follow them, so you get one consistent look without writing a line of CSS. ## Double Borders You should not see two outlines around a field. Dawn and themes built from it draw a field's border on the wrapper, outside the app's own border, and the app suppresses that automatically for both fields and dropdowns. If you still see a doubled outline, the second one is coming from somewhere else — a theme customisation or another app. Inspect the field in your browser, find which rule draws the outer line, and override it in the theme editor's **Custom CSS**. ## Options Look Too Wide or Too Narrow Every field is capped at **Field max width** (360px by default) so a row of options shares one right edge rather than stretching to whatever the theme's container happens to be. Raise or lower that setting rather than setting widths in CSS — value images and the quantity picker are positioned from it, so changing it in one place keeps them aligned. ## Value Images Look Wrong - **Different sizes** - the app crops every value image to a square at the **Value image size** setting. Upload square images so nothing important is cropped out. - **Images not appearing** - check **Show the value's image** on the option, under *What customers see*. It only appears once a value has an image. - **Images in different places down the page** - this is what the app aligns for you: a picture beside an option and a picture on a checkbox row land on the same line. If yours don't, your theme is likely constraining the block's width; check the section's own width settings first. ## Swatches - **Blank squares** - a swatch value with neither a colour nor an image shows its name in a tile instead. If you wanted a picture there, add one to the value. - **Colour swatches** - the value itself must be a hex code, including the `#` (for example `#FF0000`). - **Selected state** - the chosen swatch is outlined in the block's **Accent colour**. ## Fonts Don't Match Options inherit your theme's font. If they don't, your theme is probably setting a font on its own field classes that the app's fields don't carry: ```css .product-options-wrapper .form__label, .product-options-wrapper .product-option { font-family: inherit; } ``` ## Mobile Display An option and its quantity picker sit side by side on a desktop and stack on a phone, below 600px wide. If something overflows on mobile, check that the theme's container isn't forcing a width on the block, and that **Field max width** isn't larger than the space available. ## Still Wrong Inspect the element in your browser to see which stylesheet wins. The app's classes are listed in the Custom CSS article; write your override in the theme editor's **Custom CSS** box on the section holding the block, so it survives theme and app updates.