Docs
Free ON WEBFLOW.IO DOMAINS

Client-first Shopyflow Starter Theme walk-through

The Basic Starter Theme in Shopyflow is designed to give you a fully functional eCommerce foundation right out of the box. Built on Finsweet’s Client-First framework, this theme includes pre-configured Shopify data collections, dynamic product listings, customer account pages, and a fully integrated cart system.

The Basic Starter Theme doesn't require any configuration after the installation and Shopify Data Import, you can directly start styling your store.

In this walkthrough, we’ll explore its key components, from the header and cart system to the product pages and Klaviyo integration, helping you understand how everything connects so you can start customizing with confidence.

Theme overview

The Basic Starter Theme is a pre-configured Webflow template designed to integrate seamlessly with Shopify through Shopyflow. It comes with six CMS collections to store real-time Shopify data and includes a full set of Shopyflow components for building an advanced eCommerce site.

This theme is built using Finsweet’s Client-First framework, ensuring a structured and minimal styling approach for easy customization. It’s also fully compatible with third-party component libraries like Relume. All Shopyflow components are marked with a double-dash (--) prefix, indicating that they include Shopify-related functionality. You can find detailed documentation for these components using their assigned names.

Key Features and Components

Header Section

Mega Menu

Features dynamically sourced Collections and Tags from the Webflow CMS.

Currency Selector

Pre-configured with Shopify’s multi-currency support (requires customization based on your store's currencies).

Predictive Search

Includes a dynamic search module that show results as the user types.

User Menu

Links to customer account pages and login screens.

Cart Opener

Triggers the Shopyflow Cart Popup when clicked (not handled by Webflow interactions).

Cart System

Cart Popup Component

An entire cart component opens in a popup when a product is added to cart.

Cart Page

Features an inline cart module, where cart items dynamically update as users add products.

Product Listings and Filtering

Multiple Product Listing Components:

  1. A horizontally scrollable layout with no filters.
  2. A 4-column grid with a horizontal filter menu.
  3. A 3-column grid with a vertical filter menu.
  4. Filterable Product Listings are also used on the Shop Page and Taxonomy Pages (e.g., collection pages).

Customer Account Pages

Signup Page

Includes a sign-up form.

Login Page

Features both login and password recovery forms.

Account Activation Page

Allows users to activate their accounts.

Password Reset Page

Provides a form for resetting passwords.

Account Page

Displays order history and saved address information.

Order Details Page

Shows a detailed breakdown of past orders.

Product Page Template

Buy Module

  • Product Information Displayers
  • Custom Variant Option Selectors (Pill buttons and Color swatches)
  • Add to Cart buttons (Including ShopPay and Buy Now buttons)
  • Subscription Plan UI
  • Product Notes only appear if their CMS switches are enabled.
  • Related Products Section – Displays recommended items below the Buy Module.

Klaviyo Email Marketing Integration

An opt-in form for Klaviyo. Simply enter your Klaviyo API key in the Shopyflow Webflow app and set the Klaviyo List ID to activate it.

Installation and Shopify Data Import/Sync

The Shopyflow setup process seamlessly connects your Shopify store with Webflow, allowing you to manage products, variants, and taxonomies directly within Webflow’s CMS. This walkthrough covers the installation of the Shopyflow Shopify App, connecting it to a Webflow project, and importing Shopify data into Webflow.

Step 1: Installing the Shopyflow Shopify App

  1. Open Shopify Admin, search for Shopyflow, and install the app.
  2. Once installed, log in to your Shopyflow account or sign up for free.
  3. Click "Connect to a Webflow Project" and select the Starter Theme you just cloned.
  4. Authorize the app, save the connection, and open Webflow to proceed.

Step 2: Enabling Shopyflow on Webflow

  1. Open the Shopyflow Webflow App from the Apps tab.
  2. Click "Installation" and enable "Auto-install" to inject the necessary installation code into Webflow’s site settings.
  3. Check the "I understand" box, save the changes, and publish your site.

Step 3: Importing Shopify Data into Webflow CMS

  1. In the Shopyflow App, go to "Import and Manage Shopify Data".
  2. The app automatically maps Shopify data to the Webflow CMS collections:
    • Products and Variants store product information.
    • Collections, Tags, Vendors, and Product Types manage taxonomies.
  3. If necessary, select products to exclude from the sync.
  4. Click "Continue" to run a final check, then start the import process.
  5. Depending on your store size, the import may take a few minutes—check the CMS for newly created items.
Custom Option Selectors in Product Listing

When building Product Listings in Webflow with Shopyflow, each product item functions as a Buy Module—meaning you can include components like add-to-cart buttons, dynamic image galleries, and variant option selectors within each item. However, Webflow’s nested collection limitations allow only one nested collection per page, which can create challenges when displaying both image galleries and variant selectors dynamically.

In this guide, we’ll walk through how to work around this limitation while ensuring your Buy Modules remain fully functional. We’ll explore how gallery image thumbnails are sourced from Shopify via Webflow’s CMS, using the single nested collection slot for images while still dynamically displaying variant options on page load. Let’s take a closer look at how this setup works!

Theme overview

The Basic Starter Theme is a pre-configured Webflow template designed to integrate seamlessly with Shopify through Shopyflow. It comes with six CMS collections to store real-time Shopify data and includes a full set of Shopyflow components for building an advanced eCommerce site.

This theme is built using Finsweet’s Client-First framework, ensuring a structured and minimal styling approach for easy customization. It’s also fully compatible with third-party component libraries like Relume. All Shopyflow components are marked with a double-dash (--) prefix, indicating that they include Shopify-related functionality. You can find detailed documentation for these components using their assigned names.

Key Features and Components

Header Section

Mega Menu

Features dynamically sourced Collections and Tags from the Webflow CMS.

Currency Selector

Pre-configured with Shopify’s multi-currency support (requires customization based on your store's currencies).

Predictive Search

Includes a dynamic search module that show results as the user types.

User Menu

Links to customer account pages and login screens.

Cart Opener

Triggers the Shopyflow Cart Popup when clicked (not handled by Webflow interactions).

Cart System

Cart Popup Component

An entire cart component opens in a popup when a product is added to cart.

Cart Page

Features an inline cart module, where cart items dynamically update as users add products.

Product Listings and Filtering

Multiple Product Listing Components:

  1. A horizontally scrollable layout with no filters.
  2. A 4-column grid with a horizontal filter menu.
  3. A 3-column grid with a vertical filter menu.
  4. Filterable Product Listings are also used on the Shop Page and Taxonomy Pages (e.g., collection pages).

Customer Account Pages

Signup Page

Includes a sign-up form.

Login Page

Features both login and password recovery forms.

Account Activation Page

Allows users to activate their accounts.

Password Reset Page

Provides a form for resetting passwords.

Account Page

Displays order history and saved address information.

Order Details Page

Shows a detailed breakdown of past orders.

Product Page Template

Buy Module

  • Product Information Displayers
  • Custom Variant Option Selectors (Pill buttons and Color swatches)
  • Add to Cart buttons (Including ShopPay and Buy Now buttons)
  • Subscription Plan UI
  • Product Notes only appear if their CMS switches are enabled.
  • Related Products Section – Displays recommended items below the Buy Module.

Klaviyo Email Marketing Integration

An opt-in form for Klaviyo. Simply enter your Klaviyo API key in the Shopyflow Webflow app and set the Klaviyo List ID to activate it.

Installation and Shopify Data Import/Sync

The Shopyflow setup process seamlessly connects your Shopify store with Webflow, allowing you to manage products, variants, and taxonomies directly within Webflow’s CMS. This walkthrough covers the installation of the Shopyflow Shopify App, connecting it to a Webflow project, and importing Shopify data into Webflow.

Step 1: Installing the Shopyflow Shopify App

  1. Open Shopify Admin, search for Shopyflow, and install the app.
  2. Once installed, log in to your Shopyflow account or sign up for free.
  3. Click "Connect to a Webflow Project" and select the Starter Theme you just cloned.
  4. Authorize the app, save the connection, and open Webflow to proceed.

Step 2: Enabling Shopyflow on Webflow

  1. Open the Shopyflow Webflow App from the Apps tab.
  2. Click "Installation" and enable "Auto-install" to inject the necessary installation code into Webflow’s site settings.
  3. Check the "I understand" box, save the changes, and publish your site.

Step 3: Importing Shopify Data into Webflow CMS

  1. In the Shopyflow App, go to "Import and Manage Shopify Data".
  2. The app automatically maps Shopify data to the Webflow CMS collections:
    • Products and Variants store product information.
    • Collections, Tags, Vendors, and Product Types manage taxonomies.
  3. If necessary, select products to exclude from the sync.
  4. Click "Continue" to run a final check, then start the import process.
  5. Depending on your store size, the import may take a few minutes—check the CMS for newly created items.
Custom Option Selectors in Product Listing

When building Product Listings in Webflow with Shopyflow, each product item functions as a Buy Module—meaning you can include components like add-to-cart buttons, dynamic image galleries, and variant option selectors within each item. However, Webflow’s nested collection limitations allow only one nested collection per page, which can create challenges when displaying both image galleries and variant selectors dynamically.

In this guide, we’ll walk through how to work around this limitation while ensuring your Buy Modules remain fully functional. We’ll explore how gallery image thumbnails are sourced from Shopify via Webflow’s CMS, using the single nested collection slot for images while still dynamically displaying variant options on page load. Let’s take a closer look at how this setup works!

Theme overview
Installation and Shopify Data Import/Sync
Custom Option Selectors in Product Listing