Docs

Installation

Shopyflow installation takes place in 2 simple steps.

  1. Configuring Shopify
  2. Connecting to Webflow

Configure Shopify

Shopyflow requires a Storefront API access token to securely connect your Shopify Store to your Webflow site. To generate your Store API access token;

  1. Head to your Shopify Admin > Settings > Apps and Sales Channels section and click Develop apps link..

What’s a Rich Text element? What’s a Rich Text What’s a Rich Text element? What’s a Rich Text element?

The rich text element allows you to create and format headings, paragraphs, blockquotes, images, and video all in one place instead of having to add and format them individually. Just double-click and easily create content.

What’s a Rich Text element? What’s a Rich What’s a Rich Text element? What’s a Rich Text ejklkjököbömnlement?What’s a Rich Text element? What’s a Rich Text element?

The rich text element allows you to create and format headings, paragraphs, blockquotes, images, and video all in one place instead of having to add and format them individually. Just double-click and easily create content.

Shopyflow requires a Storefront API access token to securely connect your Shopify Store to your Webflow site. To generate your Store API access token;

1. Head to your Shopify Admin > Settings > Apps and Sales Channels section and click Develop apps link.

What’s a Rich Text element? What’s a Rich What’s a Rich Text element? What’s a  element?What’s a Rich Text element? What’s a Rich Text element?

The rich text element allows you to create and format headings, paragraphs, blockquotes, images, and video all in one place instead of having to add and format them individually. Just double-click and easily create content.

Static and dynamic content editing

A rich text element can be used with static or dynamic content. For static content, just drop it into any page and begin editing. For dynamic content, add a rich text field to any collection and then connect a rich text element to that field in the settings panel. Voila!

A rich text element can be used with static or dynamic content. For static content, just drop it into any page and begin editing. For dynamic content, add a rich text field to any collection and then connect a rich text element to that field in the settings panel. Voila!

How to customize formatting for each rich text

Headings, paragraphs, blockquotes, figures, images, and figure captions can all be styled after a class is added to the rich text element using the "When inside of" nested selector system.

Free ON WEBFLOW.IO DOMAINS

Product Container

Product Container

Component
Container
Product identifying container

Shopify Storefront data and cart logic is bound to your Webflow elements through Shopyflow attributes. Connecting your Webflow site to Shopify is done by adding custom attributes to your Webflow elements.

Yet, you are not required to type or edit attributes manually. Shopyflow provides you with the pre-configured components needed to create your store, as copyable Webflow elements right in Webflow designer.

All the copyable Shopyflow Components are native editable Webflow elements. There is no layout or styling limitation on any element.

In the below image hover your mouse on the hotspots to see all the required Shopyflow attributes to build a product page like this in Webflow

Webflow designer
Custom Attributes
sf-add-to-cart="1"
Custom Attributes
sf-change-quantity="1"
Custom Attributes
sf-change-option="{Option Name}"
Custom Attributes
sf-cart-count="1"
Custom Attributes
sf-change-option="{Option Name}"
Custom Attributes
sf-product="{Product ID}"
Custom Attributes
sf-show-image="1"
Class name
sf-product
Target elements
Can be placed anywhere in the site
No items found.
Attribute Name
sf-product
Attribute Value
True or 1
{Shopify Product ID}
Nesting Rule
Can be placed anywhere in the site
No items found.
Product Container

Product container component provides product context to the Buy Module. It is the outermost element of the Buy Module. Product Container is a Div Block with the sf-product attribute. The attribute stores the {Shopify Product ID} as the value.

Webflow app usage

In the Shopyflow app

  1. Click Add New
  2. Select Product Container from the list
  3. In the opening screen select the product
  4. Click Copy component
  5. Paste the Product Container component anywhere in the page

Webflow app settings

Product

Select the context product that you are building a Buy Module for.

Sub-product

Switch on to make the product container a Sub-product container.

CMS

Switch on if you're sourcing the Product ID from the CMS.

Component contents

Available methods

Add to Cart Button

Attribute Name
sf-add-to-cart
Attribute Value
True or 1
Add to cart button

Adds the product to cart with the selected quantity and variant options on click. Add to Cart Button is a Div Block with the sf-add-to-cart attribute.

Add to Cart Button is a required component for Buy module in order to both adding the Product to the cart on click and for the parent Buy Module content to be fetched from Shopify.

Adds the product to cart with the selected quantity and variant options on click. Add to Cart Button is a Div Block with the sf-add-to-cart attribute.

Add to Cart Button is a required component for Buy module in order to both adding the Product to the cart on click and for the parent Buy Module content to be fetched from Shopify.

Read more →

Product Title

Attribute Name
sf-show-title
Attribute Value
True or 1
Product Title Displayer

Displays the name of the product as set in Shopify. Product Title is a Heading element with the sf-show-title attribute. The content of the element is overriden with the Shopify name of the current product on page load.

Displays the name of the product as set in Shopify. Product Title is a Heading element with the sf-show-title attribute. The content of the element is overriden with the Shopify name of the current product on page load.

Read more →

Product Description

Attribute Name
sf-show-desc
Attribute Value
True or 1
Product description displayer

Displays the description of the product as set in Shopify. Product Description is a Paragraph element with the sf-show-desc attribute. The content of the element is overridden on page load with the description of the current product as set in Shopify.

Displays the description of the product as set in Shopify. Product Description is a Paragraph element with the sf-show-desc attribute. The content of the element is overridden on page load with the description of the current product as set in Shopify.

Read more →

Product Image Gallery

Attribute Name
Attribute Value
True or 1

Product image gallery is a set of components for easily building a dynamic product image gallery by utilising Webflow Slider. It's made of following elements:

  • Webflow slider
  • Product Image
  • Thumbnails Component

Product image gallery is a set of components for easily building a dynamic product image gallery by utilising Webflow Slider. It's made of following elements:

  • Webflow slider
  • Product Image
  • Thumbnails Component
Read more →

Price

Attribute Name
sf-show-price
Attribute Value
True or 1
True or 1
with-quantity
with-sub-product
all
Dynamic price displayer

Displays the price of the selected variant as set in Shopify. Price component is a Text Block with the sf-show-price attribute. The attribute stores calculation logic selection as the attribute value.

Price Formatting

By default Shopyflow displays price values with their exact number of decimals. This means €300.49 is displayed as €300.49 whereas €300 is displayed as €300. However you can change this behaviour by adding price-decimal attribute to your Shopyflow Engine snippet:


<!-- Shopyflow Engine -->
<script defer
sf-token="[STOREFRONT API KEY]"
sf-domain="[SHOPIFY STORE DOMAIN]"
src="https://cdn.shopyflow.io/[VERSION]/shopyflow.js"
price-decimal="2"></script> 

e.g. if price-decimal is set to 2, €300 will be displayed as €300.00.

Advanced Usage

By default Shopyflow displays the currencies and decimal separators in browser's language format. This is the recommended way as it takes your customer's browser preferences into account. However if you want to change this behaviour, you can use the price-format attribute which supports the ECMAScript Internationalization API.


<!-- Shopyflow Engine -->
<script defer
sf-token="[STOREFRONT API KEY]"
sf-domain="[SHOPIFY STORE DOMAIN]"
src="https://cdn.shopyflow.io/[VERSION]/shopyflow.js"
price-format="en-US"></script> 

Use-case 1

USD currency outside of the US is by browser default displayed as US$. To change this behaviour and to show only the $ sign, you can use en-US format.

Use-case 2

If price-format is set to de-DE (German format), €300.00 will be displayed as 300,00€ in which the currency symbol comes after the number and a comma is used to separate decimals.

Displays the price of the selected variant as set in Shopify. Price component is a Text Block with the sf-show-price attribute. The attribute stores calculation logic selection as the attribute value.

Price Formatting

By default Shopyflow displays price values with their exact number of decimals. This means €300.49 is displayed as €300.49 whereas €300 is displayed as €300. However you can change this behaviour by adding price-decimal attribute to your Shopyflow Engine snippet:


<!-- Shopyflow Engine -->
<script defer
sf-token="[STOREFRONT API KEY]"
sf-domain="[SHOPIFY STORE DOMAIN]"
src="https://cdn.shopyflow.io/[VERSION]/shopyflow.js"
price-decimal="2"></script> 

e.g. if price-decimal is set to 2, €300 will be displayed as €300.00.

Advanced Usage

By default Shopyflow displays the currencies and decimal separators in browser's language format. This is the recommended way as it takes your customer's browser preferences into account. However if you want to change this behaviour, you can use the price-format attribute which supports the ECMAScript Internationalization API.


<!-- Shopyflow Engine -->
<script defer
sf-token="[STOREFRONT API KEY]"
sf-domain="[SHOPIFY STORE DOMAIN]"
src="https://cdn.shopyflow.io/[VERSION]/shopyflow.js"
price-format="en-US"></script> 

Use-case 1

USD currency outside of the US is by browser default displayed as US$. To change this behaviour and to show only the $ sign, you can use en-US format.

Use-case 2

If price-format is set to de-DE (German format), €300.00 will be displayed as 300,00€ in which the currency symbol comes after the number and a comma is used to separate decimals.

Read more →

Compare Price

Attribute Name
sf-show-compare-price
Attribute Value
True or 1
True or 1
with-quantity
with-sub-product
all
Dynamic compare price displayer

Displays the compare price of the selected variant as set in Shopify. Compare Price component is a Text Block with the sf-show-price attribute. The attribute stores calculation logic as the attribute value.

Displays the compare price of the selected variant as set in Shopify. Compare Price component is a Text Block with the sf-show-price attribute. The attribute stores calculation logic as the attribute value.

Read more →

Quantity Changer

Attribute Name
Attribute Value
True or 1

Custom Quantity Changer component is a number input that can be modified with plus and minus buttons.

Custom Quantity Changer component is a number input that can be modified with plus and minus buttons.

Read more →

Option Selector(Select input)

Attribute Name
sf-change-option
Attribute Value
True or 1
{Variant Option Name}
Variant option selector input.

Changes the selected variant option value for the assigned variant option group. Option selector is a Select Input with the sf-change attribute.The attribute stores the {Variant Option Name} as the attribute value. Option selectors options are dynamically populated with your up to date Shopify data on page load on your live site.

{Variant Option Name}

Option Name represents the different group of variations available for a specific product. Such as Color, Size, Material etc.

Webflow designer

Changes the selected variant option value for the assigned variant option group. Option selector is a Select Input with the sf-change attribute.The attribute stores the {Variant Option Name} as the attribute value. Option selectors options are dynamically populated with your up to date Shopify data on page load on your live site.

{Variant Option Name}

Option Name represents the different group of variations available for a specific product. Such as Color, Size, Material etc.

Webflow designer
Read more →

SKU

Attribute Name
sf-show-sku
Attribute Value
True or 1
Dynamic SKU displayer

Displays the SKU of the selected variant as set in Shopify. SKU is a Text Block with the sf-show-sku attribute.

Displays the SKU of the selected variant as set in Shopify. SKU is a Text Block with the sf-show-sku attribute.

Read more →

Stock

Attribute Name
sf-show-stock
Attribute Value
True or 1
Dynamic Stock Displayer

Displays the available stock number of the selected variant. Stock Displayer is a Text Block with the sf-show-stock attribute.

Displays the available stock number of the selected variant. Stock Displayer is a Text Block with the sf-show-stock attribute.

Read more →

Vendor

Attribute Name
sf-show-vendor
Attribute Value
True or 1
Vendor displayer

Displays the vendor name of the current Product. Vendor displayer is a Text Block with the sf-show-vendor attribute.

Displays the vendor name of the current Product. Vendor displayer is a Text Block with the sf-show-vendor attribute.

Read more →

Component

contents

Add to Cart Button

Action
Add to cart button
Attribute Name
sf-add-to-cart
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Add to Cart Button

Adds the product to cart with the selected quantity and variant options on click. Add to Cart Button is a Div Block with the sf-add-to-cart attribute.

Add to Cart Button is a required component for Buy module in order to both adding the Product to the cart on click and for the parent Buy Module content to be fetched from Shopify.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow Designer
  2. In the Shopyflow app; click Add new
  3. Find and click Add to Cart Button
  4. Select the Product Container again
  5. Paste the Add to Cart Button

Webflow app settings

Behaviour

Default: Adds the product to cart on click.

Buy Now: If selected the user adds the product to cart on click and gets redirected to checkout. When this option is selected the element takes an additional attribute call sf-buy-now.

Redirect : If selected the user adds the product to cart on click and gets redirected to a custom url. When this option is selected the element takes an additional attribute call sf-redirect.

Out of stock button text

Customize the text that is displayed on the add to cart button when the selected variant is out of stock.

Stock exceeded button text

Customize the text that is displayed on the button when the selected quantity exceeds the available stock for the selected variant.

Product Title

Displayer
Product Title Displayer
Attribute Name
sf-show-title
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Product Title

Displays the name of the product as set in Shopify. Product Title is a Heading element with the sf-show-title attribute. The content of the element is overriden with the Shopify name of the current product on page load.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow designer
  2. In the Shopyflow app; click add new
  3. Select Product Title.
  4. Select the Product Container again
  5. Paste Product Title component

Webflow app settings

Product Description

Displayer
Product description displayer
Attribute Name
sf-show-desc
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Product Description

Displays the description of the product as set in Shopify. Product Description is a Paragraph element with the sf-show-desc attribute. The content of the element is overridden on page load with the description of the current product as set in Shopify.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow designer
  2. In the Shopyflow app; click add new
  3. Select Product Description.
  4. Select the Product Container again
  5. Paste Product Description component

Webflow app settings

Price

Displayer
Dynamic price displayer
Attribute Name
sf-show-price
Attribute Value
True or 1
True or 1
with-quantity
with-sub-product
all
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Price

Displays the price of the selected variant as set in Shopify. Price component is a Text Block with the sf-show-price attribute. The attribute stores calculation logic selection as the attribute value.

Price Formatting

By default Shopyflow displays price values with their exact number of decimals. This means €300.49 is displayed as €300.49 whereas €300 is displayed as €300. However you can change this behaviour by adding price-decimal attribute to your Shopyflow Engine snippet:


<!-- Shopyflow Engine -->
<script defer
sf-token="[STOREFRONT API KEY]"
sf-domain="[SHOPIFY STORE DOMAIN]"
src="https://cdn.shopyflow.io/[VERSION]/shopyflow.js"
price-decimal="2"></script> 

e.g. if price-decimal is set to 2, €300 will be displayed as €300.00.

Advanced Usage

By default Shopyflow displays the currencies and decimal separators in browser's language format. This is the recommended way as it takes your customer's browser preferences into account. However if you want to change this behaviour, you can use the price-format attribute which supports the ECMAScript Internationalization API.


<!-- Shopyflow Engine -->
<script defer
sf-token="[STOREFRONT API KEY]"
sf-domain="[SHOPIFY STORE DOMAIN]"
src="https://cdn.shopyflow.io/[VERSION]/shopyflow.js"
price-format="en-US"></script> 

Use-case 1

USD currency outside of the US is by browser default displayed as US$. To change this behaviour and to show only the $ sign, you can use en-US format.

Use-case 2

If price-format is set to de-DE (German format), €300.00 will be displayed as 300,00€ in which the currency symbol comes after the number and a comma is used to separate decimals.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow designer
  2. In the Shopyflow app; click Add new
  3. Select Price
  4. Select the Product Container again
  5. Paste Price component

Webflow app settings

Calculation Logic

default: The component shows unit price of the selected variant.

with-quantity: The component shows the price of the selected variant after multiplying it with the selected quantity.

with-sub-product: The component shows the price of the selected variant after adding it with the price of the sub-product (if selected by the customer)

all: The component shows the price of the selected variant using both the quantity multiplier and the sub-product price addition.

Compare Price

Displayer
Dynamic compare price displayer
Attribute Name
sf-show-compare-price
Attribute Value
True or 1
True or 1
with-quantity
with-sub-product
all
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Compare Price

Displays the compare price of the selected variant as set in Shopify. Compare Price component is a Text Block with the sf-show-price attribute. The attribute stores calculation logic as the attribute value.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow designer
  2. In the Shopyflow app; click Add new
  3. Select Compare Price
  4. Select the Product Container again
  5. Paste Compare Price component

Webflow app settings

Calculation Logic

default: The component shows unit price of the selected variant.

with-quantity: The component shows the price of the selected variant after multiplying it with the selected quantity.

with-sub-product: The component shows the price of the selected variant after adding it with the price of the sub-product (if selected by the customer)

all: The component shows the price of the selected variant using both the quantity multiplier and the sub-product price addition.

Quantity Changer

Sub-module
Attribute Name
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Quantity Changer

Custom Quantity Changer component is a number input that can be modified with plus and minus buttons.

Read more →

Webflow app usage

  1. Open the Shopyflow app and click add new
  2. Select Quantity Changer
  3. Select the Product Container
  4. Paste the Quantity Changer component

Webflow app settings

Option Selector(Select input)

Changer
Variant option selector input.
Attribute Name
sf-change-option
Attribute Value
True or 1
{Variant Option Name}
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Option Selector(Select input)

Changes the selected variant option value for the assigned variant option group. Option selector is a Select Input with the sf-change attribute.The attribute stores the {Variant Option Name} as the attribute value. Option selectors options are dynamically populated with your up to date Shopify data on page load on your live site.

{Variant Option Name}

Option Name represents the different group of variations available for a specific product. Such as Color, Size, Material etc.

Webflow designer
Read more →

Webflow app usage

  1. Make sure the Product container is selected in the Webflow designer
  2. Open the Shopyflow app and click add new
  3. Select Option Selector
  4. In the opening dialog select the option group
  5. Click copy component
  6. Select the Product Container again
  7. Paste Option Selector component

Webflow app settings

Option Group

Select the context option group.

SKU

Displayer
Dynamic SKU displayer
Attribute Name
sf-show-sku
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
SKU

Displays the SKU of the selected variant as set in Shopify. SKU is a Text Block with the sf-show-sku attribute.

Read more →

Webflow app usage

  1. Select the Product container in the Webflow designer
  2. In the Shopyflow app; click add new
  3. Select SKU .
  4. Select the Product Container again
  5. Paste SKU component

Webflow app settings

Stock

Displayer
Dynamic Stock Displayer
Attribute Name
sf-show-stock
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Stock

Displays the available stock number of the selected variant. Stock Displayer is a Text Block with the sf-show-stock attribute.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow designer
  2. In the Shopyflow app; click add new
  3. Select Stock.
  4. Select the Product Container again
  5. Paste Stock component

Webflow app settings

Vendor

Displayer
Vendor displayer
Attribute Name
sf-show-vendor
Attribute Value
True or 1
Nesting Rule
Can be placed anywhere in the site
Product Container
>
Vendor

Displays the vendor name of the current Product. Vendor displayer is a Text Block with the sf-show-vendor attribute.

Read more →

Webflow app usage

  1. Select the Product Container in the Webflow designer
  2. In the Shopyflow app; click add new
  3. Select Vendor .
  4. Select the Product Container again
  5. Paste Vendor component

Webflow app settings

State management

No items found.

Related utilities

No items found.
Can't find a solution? Join our Discord server to get an instant reply from our experts and the community.