Shopify Online Store 2.0 themes feature enhanced app integration capabilities, making PureClarity setup faster and more streamlined than vintage themes. This guide walks you through setting up PureClarity on our personalization suite plan. We recommend booking in a call if you’d like help getting started.
Online Store 2.0 themes automatically handle PureClarity integration through app blocks, eliminating the need for manual code changes required in vintage themes.

Overview of PureClarity Content

PureClarity delivers personalized shopping experiences that convert more customers and increase average basket value. Content types available:
  • Personalized product recommendations
  • Dynamic promotional banners
  • Pop-ups and engagement overlays
  • Email personalization

Simplified Setup Process

Online Store 2.0 themes require only 3 steps:
  1. Enable the PureClarity Shopify App Embed block
  2. Set up campaigns and content in PureClarity
  3. Add PureClarity zones to your theme pages

Setting Up Campaigns First

Start by configuring what content PureClarity will display:
  1. In PureClarity, click Campaigns
  2. Follow the automated wizard for setup
  3. Select “Embedded Recommender” campaigns for automatic configuration
Setting up campaigns before adding zones ensures you have content ready to display immediately when zones are activated.
PureClarity will create several campaign types automatically: Example automated campaigns:
  • Homepage trending products
  • Product page cross-sells
  • Cart page upsells
  • Category recommendations

Testing Recommendations

Test stores may not show recommendations on all pages due to limited data. Use these strategies for testing:
  • Set minimum items to 1: Increases chances of display with limited product data
  • Use Custom Recommenders: Manually select products to show during testing

Enabling PureClarity in Your Theme

Using Theme Manager

  1. In PureClarity, click Shopify Theme Manager
  2. Wait for your store themes to load
  3. Identify your Online Store 2.0 theme (marked as current if published)
  4. Click Enable PureClarity next to your desired theme
  5. You’ll be redirected to Shopify theme settings

Activating App Embed

In the Shopify theme settings:
  1. Locate the PureClarity App Embed block
  2. Toggle it ON to activate PureClarity
  3. This enables PureClarity tracking and content display site-wide
The App Embed block must be enabled for PureClarity to function. This is a one-time setup that affects the entire theme.

Adding PureClarity Zones

Zones are content areas where PureClarity displays personalized recommendations and campaigns.

Adding a Zone

  1. In the Shopify theme editor, click Add section
  2. Find and select PureClarity Zone
  3. A new zone area appears on your page
  4. Configure the zone reference ID

Zone Configuration

Zone reference naming:
  • Use descriptive, consistent naming
  • Match references to campaigns in PureClarity
  • Follow recommended naming conventions
Recommended zone references:
Page TypeZone ReferencesPurpose
HomepageHP-01, HP-02, HP-03, HP-04Trending products, new arrivals
Product PagePP-01, PP-02Related products, alternatives
Cart PageBP-01, BP-02Upsells, recommendations

Zone Preview

The Shopify editor provides real-time preview:
  • Zones display immediately when properly configured
  • Content appears based on your campaign setup
  • Preview updates as you modify zone settings
If zones don’t display content immediately, verify that:
  • App Embed block is enabled
  • Campaigns are properly configured
  • Zone reference matches campaign targeting
Add zones to these key pages for maximum impact:

Homepage

  • 1-2 zones: Feature trending products for new visitors, personalized selections for returning customers
  • Placement: Between hero section and product collections

Product Pages

  • 1-2 zones: Show related products and alternatives
  • Benefits: Faster product discovery, valuable upsell opportunities

Cart/Basket Pages

  • 1-2 zones: Display relevant products based on cart contents
  • Goal: Increase average order value through strategic upselling

Additional Pages

Consider adding zones to:
  • Collection/category pages
  • Search results pages
  • Blog/content pages

Testing Your Setup

After adding zones:
  1. Visit your storefront and browse different pages
  2. Click through products to help PureClarity learn preferences
  3. Verify zone display across different page types
  4. Check responsive behavior on mobile and tablet
PureClarity’s recommendations improve over the first 24 hours as the AI learns from customer behavior patterns.

Advanced Features

Brand Promotion

PureClarity automatically leverages Shopify Vendors for brand recommendations: Setup requirements:
  • Collections with rule “Product Vendor is equal to [Brand Name]”
  • Collection name, description, and image represent the brand
  • Automatic detection and use in brand recommenders
Available brand features:
  • “Recommended Brands for You”
  • “Best Selling Brands”
  • Brand-specific product recommendations
Control options:
  • Disable brand recommenders in PureClarity admin
  • Navigate to Configuration > Recommenders for settings

Analytics and Insights

Monitor performance through:
  • Real-time dashboard: Updated continuously with key metrics
  • Detailed analytics: Access via Analytics section
  • Campaign performance: Track individual campaign success

Billing Management

Billing structure:
  • Frequency: Every 30 days through Shopify
  • Management: Access via “Billing Management” on Dashboard
  • Plan details: View at “My Account” > “Billing”
  • Pricing tiers: Available on PureClarity pricing page
Usage monitoring:
  • Email notifications for plan limit approaches
  • Automatic upgrade prompts when necessary
  • Grace period for plan adjustments

Uninstalling PureClarity

Online Store 2.0 themes automatically handle PureClarity removal, making uninstallation simple and clean.
Uninstall process:
  1. Go to Apps section in Shopify Admin
  2. Find PureClarity in “Installed apps”
  3. Click uninstall button (far right of app name)
Automatic cleanup:
  • PureClarity zones automatically removed from theme
  • App embed block automatically disabled
  • No manual code cleanup required
All store and user data is permanently deleted upon uninstall. PureClarity is fully GDPR compliant.

Next Steps

Immediate actions:
  • Browse your storefront: Test the customer experience across different pages
  • Monitor performance: Check real-time analytics in PureClarity dashboard
  • Optimize zones: Adjust placement based on customer interaction patterns
Future enhancements:
  • Schedule consultation: Book a call for strategic guidance
  • Explore advanced features: Review additional documentation for extended capabilities
  • Template customization: Work with support to match your brand aesthetic
The more customers interact with your personalized content, the more effective PureClarity’s machine learning becomes at driving conversions and increasing revenue.