Docs
  • INTRO
    • What is Shoplift?
    • What to Test
    • Quickstart
      • Install Shoplift
      • Create a Test
      • Edit Your Variant
      • Launch Your Test
  • TEST
    • Template Testing
      • Overview
      • Guides
        • Guide: Testing Individual Pages
        • Guide: Testing One-Click Payment Methods
        • Guide: Testing App Blocks
        • Guide: Testing Different Template Types
      • Theme Compatibility
      • Template Management
      • Switching Themes
      • Shopify Markets
      • Shopify Translate & Adapt
    • Theme Testing
      • Overview
      • Guides
        • Guide: Testing a Navigation Menu
        • Guide: Testing a Mini Cart
      • Theme Management
      • Theme Development
      • Switching Themes
    • URL Testing
      • Overview
      • Guides
        • Guide: Testing URLs
        • Guide: Testing Product Properties
    • JavaScript API (Beta)
      • isHypothesisActive
      • setAnalyticsConsent
      • getVisitorData
    • Lift Assist™
      • What is Lift Assist™?
      • How To Use Lift Assist™
      • Brand Styles
    • Audience Targeting
      • Devices
      • New and Returning Visitors
      • Custom Audiences (UTMs, Referring Domains, and Geo-targeting)
    • Test Management
      • Test Compatibility
      • Mutual Exclusion
      • QA Checklist
      • Scheduling Tests
      • Pausing Tests
      • Implementing Winning Tests
    • Performance
      • Pagespeed
      • Shopify Caching
      • CDNs and Edge Delivery
  • ANALYZE
    • Reports
      • Overview
      • Metrics
        • Goals & Reporting Metrics
        • Metric Views
      • Test Progress
      • Statistical Significance
      • Channel Groups
    • Tracking
      • Visitor Attribution
      • Web Pixel
      • Liquid Snippet
      • Anti-Flicker
      • Analytics Discrepancies
  • integrate
    • Integrations and Tooling
      • GA4 (Beta)
        • Integrate GA4 (Shopify)
        • Integrate GA4 with Google Tag Manager
        • Integrate GA4 with Elevar
        • Analyze Test Data In Google Analytics
        • Disabling the GA4 Integration
      • Subscription Apps
      • Page Builder Apps
      • Reporting Tools
      • Heatmapping Tools
      • Custom Integrations
  • ADMIN
    • Plans and Billing
      • Subscription Plans
      • Uninstalling Shoplift
    • Users and Permissions
      • Managing Team Access
      • Managing User Notifications
    • Privacy and Compliance
      • Customer Data and GDPR
  • PARTNERS & DEVELOPERS
    • Shoplift Partner Program
    • Testing on Development Stores
  • SUPPORT
    • Frequently Asked Questions
    • Get Help
    • Give Feedback
Powered by GitBook

Contact Us

  • Get help
  • Give feedback
  • Request a feature

Helpful Links

  • Shoplift
  • Shopify App Store
On this page
  • Is my theme compatible with template tests?
  • Legacy themes
  • Custom code

Was this helpful?

  1. TEST
  2. Template Testing

Theme Compatibility

PreviousGuide: Testing Different Template TypesNextTemplate Management

Last updated 8 months ago

Was this helpful?

Is my theme compatible with template tests?

All Shopify themes are compatible with template tests, but there are some things to know depending on the type of theme you have (OS1 or OS2), how much your theme allows you to customize in the Shopify Theme Editor, and any custom code you have on your theme that may interfere with testing.

If you are experiencing an issue with theme compatibility or test variants, contact support via our chat widget or reach out to us at .

Legacy themes

In 2021, Shopify released Online Store 2.0 (OS2). Templates on OS2 themes are made up of sections, which enable drag-and-drop customization in the Shopify Theme Editor. This functionality was made possible by replacing Liquid templates (legacy) with JSON templates (OS2).

Because Liquid templates can have limited editing capabilities in the Shopify Theme Editor, we've developed a few methods for testing legacy themes.

Liquid to JSON conversion

When you select a liquid template as your original template in Shoplift, we run a check to determine whether your template can be converted to the newer architecture.

If it can be converted, all variant options (Duplicate, Select, and Create with Lift Assist™) will be available.

If you then decide to duplicate the Liquid template for testing, its Liquid and HTML code will be copied into a section file in the new JSON template (variant). This upgraded JSON template will enable you to add additional sections from your theme, as well as drag, drop, and reorder them.

If your template cannot be converted, you can still run a test with your liquid original template by choosing the "Select" variant option. Depending on your theme, you might also be able to customize your variant in the Shopify Theme Editor.

Custom code

Occasionally, themes will have custom code that prevents alternate template variants (JSON copies of the original template with a suffix in the filename) from inheriting the CSS styles from their original counterpart. This can prevent the variant template from being a pixel-perfect copy of the original.

Examples of conditional code that prevent duplicate templates created for testing could be any of the following:

  • conditional code such as template == 'index'

  • CSS that references the <div> or #id of specific elements instead of the class

  • any code that is limited to styling a specific template

If this occurs during test creation, we suggest you review your theme directory for any code that might prevent an alternate template of the same type from correctly inheriting the CSS styles of the original.

We’re here to help if you encounter any issues when testing with Shoplift. If you would like us to speak with your theme developer to discuss theme compatibility, you can reach out to us at .

help@shoplift.ai
help@shoplift.ai