> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pureclarity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Online Store 2.0 Theme Setup

> Streamlined setup guide for PureClarity personalization on modern Shopify Online Store 2.0 themes with enhanced app integration

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](https://calendly.com/john-barton-4zg/30min) if you'd like help getting started.**

<Info>
  Online Store 2.0 themes automatically handle PureClarity integration through app blocks, eliminating the need for manual code changes required in vintage themes.
</Info>

## 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

<Tip>
  Setting up campaigns before adding zones ensures you have content ready to display immediately when zones are activated.
</Tip>

PureClarity will create several campaign types automatically:

**Example automated campaigns:**

* Homepage trending products
* Product page cross-sells
* Cart page upsells
* Category recommendations

### Testing Recommendations

<Note>
  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
</Note>

## 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

<Warning>
  The App Embed block must be enabled for PureClarity to function. This is a one-time setup that affects the entire theme.
</Warning>

## 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 Type        | Zone References            | Purpose                         |
| ---------------- | -------------------------- | ------------------------------- |
| **Homepage**     | HP-01, HP-02, HP-03, HP-04 | Trending products, new arrivals |
| **Product Page** | PP-01, PP-02               | Related products, alternatives  |
| **Cart Page**    | BP-01, BP-02               | Upsells, 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

<Tip>
  If zones don't display content immediately, verify that:

  * App Embed block is enabled
  * Campaigns are properly configured
  * Zone reference matches campaign targeting
</Tip>

## Recommended Zone Placement

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

<Info>
  PureClarity's recommendations improve over the first 24 hours as the AI learns from customer behavior patterns.
</Info>

## 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](/features/analytics/overview)
* **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](https://www.pureclarity.com/us/pricing/)

**Usage monitoring:**

* Email notifications for plan limit approaches
* Automatic upgrade prompts when necessary
* Grace period for plan adjustments

## Uninstalling PureClarity

<Note>
  Online Store 2.0 themes automatically handle PureClarity removal, making uninstallation simple and clean.
</Note>

**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

<Info>
  All store and user data is permanently deleted upon uninstall. PureClarity is fully GDPR compliant.
</Info>

## 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](https://calendly.com/john-barton-4zg/30min) for strategic guidance
* **Explore advanced features**: Review [additional documentation](/features) 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.