Enable App Embed
Activate the Podifai app embed block in your Shopify theme.
Enable App Embed explains how to make Podifai options appear on your Shopify product pages. Use the default App Embed for automatic placement, or add the App Block when you need exact placement control.
Overview
Podifai uses a Shopify App Embed to display product options on your storefront. In the default setup, you enable the app embed once and Podifai automatically renders options on product pages that have an option set. If you need exact placement control, you can also add the Podifai app block inside a product template.
Default Setup: Enable the App Embed
Podifai's onboarding checklist includes an Activate app step with a button that takes you directly to the Shopify theme editor. You can also navigate there manually:
- In your Shopify admin, go to Online Store → Themes
- Click Customize on your active theme
- In the theme editor, click App embeds (toggle icon in the left sidebar)
- Find Podifai in the list and toggle it on
- Click Save
Once enabled, Podifai detects the change automatically and marks the onboarding step as complete.
Turn on the Podifai App Embed in Shopify
What this shows
- Open the Shopify theme editor.
- Go to App embeds.
- Turn on Podifai and save the theme.
Verify It's Working
After enabling the app embed, visit any product page where you have added options. The option fields should appear on the product page. Inside the Podifai dashboard, a completed checkmark will show next to the "Activate app" step.
Custom Placement: Add the App Block
By default, the App Embed inserts options automatically on product pages. If you want more control over where the options appear (e.g. below the price, inside a specific section), you can use a Podifai App Block instead:
- In your Shopify admin, go to Online Store → Themes → Customize
- Navigate to a Product page template
- In the section where you want options to appear, click Add block
- Under Apps, select Podifai
- Drag the block to your desired position within the section
- Click Save
App Blocks give you drag-and-drop control over placement. If you add the Podifai App Block to a product template, custom options and Live Preview render at that exact position even when the App Embed toggle is off — the App Block alone is enough to load Podifai on that template.
When to use which:
- App Embed only — easiest setup. Podifai inserts options automatically on every product page that has an option set, no template editing required.
- App Block only — use when you want options at a specific location and only on the templates where you have added the block. App Embed can stay off.
- Both enabled — also fine. The App Block overrides the App Embed's default placement on templates where the block is present; the App Embed continues to render automatically on templates without a block.
Add the Podifai App Block to a product template
What this shows
- Open a product page template in the theme editor.
- Add a block from the Apps section.
- Place the Podifai block where the customizer should appear.
Multiple Themes
Both App Embed and App Block settings are per-theme. If you switch to a different theme, you will need to enable the Podifai app embed (and optionally add the App Block) again in the new theme's settings.
Enable Podifai on another Shopify theme
What this shows
- Open the new or unpublished theme.
- Enable the Podifai app embed for that theme.
- Add the App Block again if you use custom placement.
Next Step
With the app embed active, your options are now visible to customers. Visit your product page to verify everything looks correct.
FAQ
What is the Podifai app embed?
The Podifai app embed is the default Shopify theme setting that lets Podifai show product options on product pages.
When should I use the Podifai app block?
Use the App Block when you want to control the exact placement of the customizer inside a product page template.
Do I need to enable Podifai again after changing themes?
Yes. Shopify app embed and app block settings are theme-specific, so enable Podifai again for each theme you publish or test.
Do I need to enable the App Embed if I'm using the Podifai App Block?
No. If the Podifai App Block is added to your product template, custom options and Live Preview will still render at the block's position even when the App Embed toggle is off. Either App Embed or App Block alone is enough for Podifai to load on that template — you don't need both.
