Theme Compatibility
Check Podifai theme setup, App Embed or App Block placement, and Inline preview compatibility. Compare Popup mode when needed.
Last updated: 2026-11-06
Theme Compatibility explains how Podifai appears on Shopify product pages, how Inline Live Preview depends on theme layout, when to use App Embed or App Block, and when Popup display mode is a better fit.
Overview
Podifai is built for modern Shopify Online Store 2.0 themes. Custom options can display on almost all themes through App Embed or App Block. Inline Live Preview depends more on the theme's product image gallery layout. Popup display mode is available for a dedicated customization experience.
How Podifai Appears on Your Theme
Podifai can appear on your product page in two ways:
- App Embed — The default setup. Podifai automatically shows options on product pages.
- App Block — Custom placement. Add the Podifai block exactly where you want it in the product template.
Start with the App Embed. Use the App Block if your theme needs a specific placement. See Enable App Embed for setup steps.
Will custom options show on my product page?
In almost all cases, yes. Custom options can display through App Embed, App Block, or a theme's standard product form. App Embed is the easiest setup. App Block is best when you want to control the exact inline placement.
If options don't appear in the right place on your theme, add the Podifai App Block to your product template to control the exact placement. See Enable App Embed for setup steps.
Will Live Preview work on my theme?
Podifai supports both Inline and Popup display modes. Popup mode opens the customizer in a dedicated experience and is useful when the product page should remain simple. See Customizer Display Modes.
Today, embedded or inline Live Preview is more sensitive to the theme. It overlays or works near the product image area, so compatibility depends on how the theme renders the product gallery, image zoom, sliders, and product media layout. Podifai currently verifies embedded or inline Live Preview on the theme setups listed below.
These tips usually help when testing embedded or inline Live Preview:
- Use clear product images.
- Use square product images when possible.
- Test the preview on desktop and mobile.
- Try a Shopify free theme to check whether an issue is theme-specific: in Shopify Admin go to Online Store → Themes → Add theme, add a free theme such as Dawn, turn on Podifai under Customize → App embeds in that theme, then preview your product page there.
Verified Compatible Themes
The current embedded or inline custom option Live Preview test set covers 29 themes (30 setups, because Impulse is tested twice). Custom options can still work on most modern themes, even when the theme is not listed here. For embedded or inline Live Preview, these are the theme names currently verified by the Podifai team:
Atelier, Broadcast, Craft, Dawn, Dwell, Empire, Fabric, Focal, Heritage, Horizon, Hyper, Impact, Impulse, Origin, Pipeline, Prestige, Publisher, Reformation, Refresh, Ride, Rise, Ritual, Sequence, Spotlight, Stiletto, Symmetry, Tinker, Trade, and Zenith.
The videos below demonstrate App Embed, the custom options form, and Live Preview on these themes (not every listed theme has a video). Themes update over time, so use the videos as setup references, then check your own theme version and product template. If something looks different on your version, send us the theme version.
Podifai works with the Craft theme
Podifai works with the Dwell theme
Podifai works with the Empire theme
Podifai works with the Fabric theme
Podifai works with the Focal theme
Podifai works with the Heritage theme
Podifai works with the Horizon theme
Podifai works with the Hyper theme
Podifai works with the Impact theme
Podifai works with the Origin theme
Podifai works with the Pipeline theme
Podifai works with the Prestige theme
Podifai works with the Publisher theme
Podifai works with the Reformation theme
Podifai works with the Ride theme
Podifai works with the Ritual theme
Podifai works with the Spotlight theme
Podifai works with the Symmetry theme
Podifai works with the Trade theme
Switching Themes
App Embed and App Block settings are theme-specific. If you publish or test a different theme, enable App Embed in that theme or add the Podifai App Block to the product template you will use. Either setup can load Podifai on that template. Follow Enable App Embed for the two placement methods.
Check Your Product Template
- Confirm the exact theme and product template used by the affected product page.
- Check App Embed or App Block in that theme; test a product with saved Podifai options.
- Check the configured Inline or Popup mode and whether its options or Customize button appear.
- If Inline preview fails, compare with Popup in the test setup and review the product gallery behavior.
- If shopper layer editing fails, check theme image zoom and slider interaction against the on-canvas image control theme notes.
Show the Final Preview in the Cart
For Horizon cart thumbnails, follow the tested Liquid edit in Cart Preview Image. The edit is specific to the documented Horizon markup; check other themes separately.
Cart thumbnails, order emails, and packing slips are all controlled by your theme or Shopify templates. These guides cover each:
- Cart Preview Image: the cart page and cart drawer thumbnail (Horizon).
- Order confirmation emails: show selections and the preview in the email.
- Packing slips: show selections and uploads on printed slips.
Need Help Checking a Theme?
Send your store URL and theme name through the chat icon on the left side of the page, or by email to chelsea@podifai.com. Include the product URL where Podifai should appear. Our team is online every day from 09:00 to 24:00, Melbourne time, but theme-specific fixes may take longer to investigate and resolve.
Include the theme version if known, the affected product template, Inline or Popup mode, device/browser, and a short recording of the problem. Mention whether the issue occurs with option fields, preview display, shopper editing, or Add to Cart. See support issue details.
FAQ
Does Podifai work with Shopify Online Store 2.0 themes?
Yes. Podifai is built for modern Shopify Online Store 2.0 themes. Custom options can display on almost all themes through App Embed or App Block, and the customizer can use either Inline or Popup display mode.
What should I do if options appear in the wrong place?
Use the Podifai App Block in your Shopify product template to control exactly where the customizer appears.
Do I need to set up Podifai again after switching themes?
Yes. App Embed and App Block settings are theme-specific, so enable Podifai again after publishing or testing a different theme.
Which Shopify themes are verified compatible with Podifai?
Podifai's embedded or inline custom option Live Preview is currently verified on 30 Shopify theme setups, including Atelier, Broadcast, Craft, Dawn, Dwell, Empire, Fabric, Focal, Heritage, Horizon, Hyper, Impact, Impulse, Origin, Pipeline, Prestige, Publisher, Reformation, Refresh, Ride, Rise, Ritual, Sequence, Spotlight, Stiletto, Symmetry, Tinker, Trade, and Zenith.
Will Podifai work with themes not on the verified list?
Yes, in most cases. Custom options work on most modern Shopify themes through App Embed or App Block. Inline Live Preview depends more on the theme's product gallery layout. Popup mode is available when you want a dedicated customization experience that is less dependent on the inline gallery layout.
Will custom options show up on my Shopify theme?
In almost all cases, yes. Custom options can display through App Embed or App Block. If the automatic App Embed placement does not fit your theme layout, add the Podifai App Block to control the exact position.
Live Preview isn't showing correctly on my theme — what should I do?
Inline Live Preview is sensitive to product gallery structure, image zoom, and slider behavior. If it does not render correctly, try Popup display mode or send us your theme name, store URL, and product URL so we can check compatibility.
