If your custom product options or swatches are not rendering on your storefront product pages, follow this quick 3-step verification checklist to resolve the issue.
Step 1: Verify Product Selection & Assignment
Custom options only display on products or collections explicitly assigned to an option set.
Open the Key Product Options app dashboard.
Navigate to Option Sets and select your target option set.
Open the Product Selection tab.
Confirm that the specific product (or its parent collection) is explicitly added to the assignment list.
Click Save in the top contextual bar.
Step 2: Ensure the App Block is Added to Your Theme
Your online store theme requires the native app block integration to render options visually on product templates.
Go to Shopify Admin > Online Store > Themes and click Customize on your active theme.
Navigate to the Default Product Page template.
Check the left sidebar to ensure the Keystone Product Options block is present under the Apps or Main Product Information section.
Drag the block near your Add to Cart button or Quantity Selector.
Step 3: Save and Publish Theme Changes
Draft or unsaved theme modifications will prevent app blocks from rendering live to shoppers.
In the top-right corner of the Theme Editor, verify that all changes are Saved.
If working on a draft theme, ensure that the theme is set to Published.
Open a new incognito window, clear your browser cache, and refresh the live product page to test visibility.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article