Theme Compatibility

Understand Shopify theme requirements for Gyde blocks and how to work with legacy themes.

Gyde's theme extension blocks (Inline Section, Product Page Teaser) require a Shopify Online Store 2.0 theme. The Floating Popup App Embed works on all themes.

Online Store 2.0 vs legacy themes

Feature	OS 2.0 themes	Legacy themes
Floating Popup (App Embed)	✓	✓
Inline Quiz Section block	✓	✗
Product Page Teaser block	✓	✗
Theme Editor deep links	✓	✗

How to check if your theme is OS 2.0

In your Shopify admin, go to Online Store → Themes.
Click Customize on your active theme.
If you see an App embeds icon (puzzle piece) in the left toolbar, your theme supports OS 2.0 blocks.
Alternatively, look for Add section and Add block options in the editor — these are OS 2.0 features.

Popular OS 2.0 themes include Dawn, Sense, Craft, Crave, Refresh, and most premium themes published after 2021.

Using Gyde on a legacy theme

If you're on a legacy theme and can't upgrade:

The App Embed block works on all themes. Enable it in Online Store → Themes → Customize → App embeds and the quiz bubble will appear on every page.

Option 2 — Embed via custom HTML

If your theme has a Custom HTML or Custom Liquid section, you can paste a quiz iframe directly:

<div style="width: 100%; max-width: 720px; margin: 0 auto;">
  <iframe
    src="https://your-gyde-domain.com/f/YOUR_QUIZ_ID"
    width="100%"
    height="650"
    frameborder="0"
    allow="microphone; camera"
    style="border: none; border-radius: 12px;"
  ></iframe>
</div>

Replace YOUR_QUIZ_ID with the quiz's ID (visible in the quiz URL inside the Gyde app).

Option 3 — Upgrade your theme

Upgrading to a free OS 2.0 theme like Dawn unlocks the full set of Gyde blocks. Shopify's Theme Store offers many free and paid OS 2.0 options.

Theme conflicts

On rare occasions a theme's CSS may conflict with the quiz widget:

Bubble hidden behind other elements — add z-index: 9999 to .gyde-widget-container via your theme's CSS editor.
Quiz panel cut off — the panel renders at the browser viewport level and should not be affected by theme overflow settings. If it is, check for overflow: hidden on the <body> or <html> element in your theme CSS.

If you encounter a persistent conflict, contact Gyde support with the name of your theme.

Full Page Embed

Modal Button Embed

On This Page