Theme App Extensions

Theme App Extensions (TAE) is the recommended way to integrate ReplayPRO with your Shopify store. This modern approach provides better performance, reliability, and easier management.

What are Theme App Extensions?

Theme App Extensions is Shopify's modern method for apps to add functionality to your storefront. Instead of injecting scripts via Script Tags, TAE adds app blocks directly to your theme through the theme editor.

Benefits of Theme App Extensions

Performance

  • Faster loading - Scripts are optimized by Shopify
  • No render blocking - Loads asynchronously
  • Better caching - Leverages Shopify's CDN

Reliability

  • Theme compatibility - Works with all Online Store 2.0 themes
  • No conflicts - Isolated from other scripts
  • Consistent behavior - Managed by Shopify's infrastructure

Management

  • Easy toggle - Enable/disable from theme editor
  • No code editing - No need to edit theme files
  • Theme safe - Survives theme updates and changes

Enabling Theme App Extensions

Step 1: Open Theme Settings

  1. In ReplayPRO, go to Settings or the Dashboard
  2. In the Setup Guide or Integration Method section, click Open Theme Settings
  3. This opens your Shopify theme editor with the Apps section focused

Step 2: Enable the Recorder Block

  1. In the theme editor, look for App embeds or Apps
  2. Find ReplayPRO in the list
  3. Toggle the Recorder block to ON
  4. Click Save

Step 3: Verify Installation

  1. Return to ReplayPRO
  2. Click Check Status
  3. You should see "Theme App Extension is enabled and working correctly"

Checking Status

At any time, verify your integration:

  1. Go to Settings > Integration Method
  2. Click Check Status
  3. Status will show:
    • Active (green) - Extension is enabled and working
    • Pending (yellow) - Extension needs to be enabled

Troubleshooting

"Recorder block is disabled"

The block exists but is turned off:

  1. Open Theme Settings
  2. Find ReplayPRO in App embeds
  3. Toggle the Recorder to ON
  4. Save and check status again

"Recorder block is not yet enabled"

The block hasn't been added:

  1. Open Theme Settings
  2. Go to App embeds section
  3. Find and enable ReplayPRO Recorder
  4. Save changes

Extension Not Appearing

If ReplayPRO doesn't appear in your theme editor:

  1. Ensure your theme is Online Store 2.0 compatible
  2. Try refreshing the theme editor
  3. Contact support if the issue persists

Using Legacy Theme

If your theme doesn't support App embeds:

  1. Consider upgrading to an Online Store 2.0 theme
  2. Or continue using Script Tags (legacy method)
  3. Contact support for assistance

Switching from Script Tags

If you're currently using Script Tags:

  1. Go to Settings > Integration Method
  2. Click Switch to Theme App Extensions
  3. Follow the prompts to enable the extension in your theme
  4. Verify with Check Status

The switch preserves all your existing data and settings.

Technical Details

What Gets Added

The Theme App Extension adds:

  • Recorder script - Captures visitor sessions
  • Configuration - Your ReplayPRO settings
  • Minimal footprint - Optimized for performance

Where It Loads

The extension loads:

  • On all storefront pages (except checkout)
  • After page content loads (non-blocking)
  • Only when enabled in theme settings

Data Captured

When enabled, the extension captures:

  • Page views and navigation
  • Session recordings (when enabled)
  • Cart and purchase events
  • Custom events you've configured

Best Practices

Keep Extension Enabled

Only disable the extension if you need to completely stop recording. For temporary pauses, use the Recording toggle in Settings instead.

Regular Status Checks

Periodically verify the extension is working:

  1. Check Status in Settings
  2. Verify recent sessions are being recorded
  3. Test by visiting your store

Theme Updates

After theme updates:

  1. Check that the extension is still enabled
  2. Test recording functionality
  3. Report any issues to support

FAQ

Will this slow down my store?

No. Theme App Extensions are optimized by Shopify and load asynchronously without blocking your store.

Does it work with all themes?

TAE works with Online Store 2.0 themes. Older themes may need to use Script Tags.

Can I use both methods?

No. Use either Theme App Extensions or Script Tags, not both. TAE is recommended.

What if I switch themes?

You'll need to enable the ReplayPRO extension in your new theme. Your data and settings are preserved.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us