Burst Commerce Burst Commerce
Flair
Getting Started
Badges
Banners
Support

Flair Gen 3 Upgrade Guide

3 min read
updated Oct 03 2024

Overview

This guide contains everything you need to know about upgrading to Flair Gen 3.

Upgrade Instructions

Heads Up! If you run into any issues during the upgrade, or need a hand, you can switch back to Flair Gen 2 and contact support so we can assist you.

Grant Flair data access if needed

Flair Gen 3 requires read-only access to some additional Shopify data (the Storefront APIs).

  • Visit Flair > Settings > Flair Generation.
  • If you see the following "Additional Shopify data access is needed" message, click the link and follow the instructions to grant Flair access to the new data. Flair data access

Upgrade to Flair Gen 3

  • Visit Flair > Settings > Flair Generation and click Edit .

  • Choose Flair Gen 3 (recommended).

  • Review the Flair Gen 3 changes (if any)

    Some features have changed in Flair Gen 3 (see the full list of changes). Review any impacted items before continuing. Flair review changes

  • Click the link to preview Flair Gen 3 in your store: Flair preview

    Then review your Flair promotions in your store, such as on your home, collections, search, cart and product pages.

  • Once everything looks good, click Save & Publish to complete the upgrade.

How to cancel the Flair Gen 3 preview

  • You can cancel the Flair Gen 3 preview by clicking this link at the bottom of the Flair generation form:

    Cancel Flair Gen 3 preview

    Otherwise, the preview will expire automatically after 24 hours.

Flair Gen 3 changes

We made every effort to maintain backward compatibility. However, a handful of features have been modified or are no longer available in Flair Gen 3.

Here is a list of the possible Flair Gen 3 changes:

Shop metafields are no longer supported.

Shopify restricts access to shop metafields using their latest tools (Storefront APIs), so Flair can not access them.

Impact

  • After the upgrade, badges and banners using shop metafield rules or dynamic text will be unpublished.

The inventory rule availability option has changed.

The inventory rule availability options 'allow overselling' and 'can sell out' have been removed. The ‘out of stock’ rule has two new availability options: 'available for sale' and 'not available for sale'.

Impact

  • Inventory 'in stock' and 'between' badges will no longer support an availability option.
  • Inventory 'out of stock' badges will be modified from ‘allow overselling’ → 'available for sale' and from ‘can sell out’ → 'not available for sale'.

Custom CSS in layouts is no longer supported.

Custom CSS in badge and banner layouts is no longer supported. Flair now supports CSS custom properties to apply customizations.

Impact

  • Custom CSS will no longer be applied to badge and banner layouts, which may impact their display.

The variant badge setting has changed.

Previously, the variant badge setting supported multiple options for selecting the current variant, which allowed a fallback for some legacy themes. This should not be necessary going forward, so we’ve simplified this so variant badges are either ‘enabled’ or ‘disabled’.

Impact

  • After the upgrade, the variant badge settings 'use selected variant, or first available' and 'use selected variant, or first variant' will be set to 'enabled’.