Theme integration
OptionWise installs into your theme as a single plugin you add once. This page covers adding it and what to expect with popular themes.
Adding the plugin
OptionWise needs an Online Store 2.0 theme — the modern format that supports product-page section blocks. The app checks this for you when you choose a theme during setup. If your theme is compatible, add the OptionWise plugin to your product section from the theme editor.
The full step-by-step — and where to position the plugin — is covered in Plugin placement.
You only add the plugin once. After that, every option set you publish appears automatically on its targeted products — you don’t return to the theme editor for each one.
Theme compatibility
OptionWise works with virtually all Online Store 2.0 themes. That includes Shopify’s free themes — Dawn and its relatives (Craft, Studio, Sense, Refresh, and so on) — and the large majority of paid themes. On a few themes with unusual markup, OptionWise can’t attach to the product form — see Form detection failures.
Themes that are not compatible are older “vintage” themes built before Online Store 2.0 (for example the original Debut). These don’t support section blocks, so the OptionWise plugin can’t be added. If the app’s compatibility banner reports your store as incompatible, switch to a modern theme.
If options don’t render after adding the plugin
Most issues come down to one of three things: the plugin isn’t on the published theme, the option set isn’t published, or it doesn’t target the product. Work through Options not showing. If the plugin is in place but OptionWise can’t attach to the product form, see Form detection failures.