Using STOQ with Shopify themes

STOQ requires specific Shopify theme compatibility to deliver back-in-stock signups and preorder functionality to your customers. Understanding which theme types support STOQ and how to verify app embed availability ensures seamless integration with your store.

Supported theme types

STOQ works with modern Shopify themes that support app embed blocks, which are essential for displaying notification buttons and preorder widgets on your storefront.

Online Store 2.0 Themes

• Full compatibility: All Online Store 2.0 themes support STOQ's app embed functionality
• Modern architecture: These themes use JSON templates that fully support app blocks and app embeds
• Recommended choice: Online Store 2.0 themes provide the best experience with STOQ features

Theme Compatibility Requirements

• Your theme must support app embed blocks for STOQ to function properly. App embeds allow STOQ to add "Notify Me" buttons and preorder widgets to your store pages
• Themes without app embed support cannot display STOQ functionality to customers

Important: Online Store 1.0 (vintage) themes most likely do not support the app embed features required for STOQ functionality. If you're using an older theme, we recommend that you check if the theme supports app embeds. Alternatively, you'll need to upgrade to an Online Store 2.0 compatible theme to use STOQ.

How to check app embed availability

Before installing STOQ, verify that your current theme supports app embeds by following these steps.

Step 1: Access Your Theme Editor

1. From your Shopify admin, go to Online Store > Themes
2. Find your current theme and click Customize
3. This opens the theme editor where you can check for app embed support

Step 2: Check for App Embeds Section

1. In the theme editor sidebar, look for Theme settings at the bottom
2. Click on Theme settings
3. Look for an App embeds section in the settings panel

Step 3: Verify App Embed Support

• If you see an App embeds section, your theme supports STOQ
• If there's no App embeds section, your theme may not be compatible
• Online Store 2.0 themes will always have this section available

Enabling STOQ App Embeds

Once you've confirmed theme compatibility and installed STOQ, you'll need to activate the app embed to display notification functionality.

Automatic Activation

1. During STOQ onboarding, click Enable app embed
2. This opens your theme editor in a new tab
3. STOQ will attempt to automatically enable the app embed

Manual Activation

If automatic activation doesn't work:

1. In the theme editor, go to Theme settings > App embeds
2. Find STOQ in the list of available app embeds
3. Toggle the STOQ switch to enabled
4. Click Save in the top right corner

Known Limitations

STOQ's theme compatibility has specific requirements that may affect some merchants.

• Online Store 1.0 themes: Not supported due to lack of app embed functionality
• Custom themes: May require developer assistance to ensure proper app embed support
• Heavily modified themes: Some customizations might interfere with app embed functionality

Troubleshooting

Common theme compatibility issues and their solutions.

FAQs

Common questions about STOQ's Shopify theme compatibility.

Does STOQ work with all Shopify themes?

STOQ works with Online Store 2.0 themes that support app embeds. Online Store 1.0 themes that use app embeds may be compatible. We recommend checking your theme's app embeds section to confirm.

How do I know if my theme is Online Store 2.0?

Check your theme information in Shopify admin under Online Store > Themes, or look for the App embeds section in theme settings.

Can I use STOQ with a custom theme?

Yes, if your custom theme supports app embeds. You may need developer assistance to ensure proper compatibility.

What happens if I switch themes after installing STOQ?

You'll need to re-enable the STOQ app embed in your new theme's settings if it supports app embeds.

Will STOQ slow down my theme?

STOQ is optimized for performance and only loads scripts on pages where notification functionality is needed. STOQ is also Built For Shopify - adhering to the highest performance standards set by Shopify for storefronts.

Updated on: 03/07/2025