Fairloom Essentials Help Centre
Written against apps/essentials on main after #18 (live preview, disabled plan fields). Contact address is a placeholder until the domain is registered.
Getting started
- Install Fairloom Essentials from the Shopify App Store and approve the permissions (read products, read themes).
- Choose a plan on Shopify's plan page: Free, Essentials or Plus. You can change it any time.
- Open the app. Home lists the ten blocks. If your live theme already uses other storefront apps, Guided setup names them and suggests which Fairloom blocks can replace them.
- Turn a block on, then click Add to theme (for blocks you place on a page) or Switch on in theme (for app embeds, which appear on every page). The theme editor opens on the right page; click Save there.
- Configure it. Blocks with a Settings button are set up in the app, where a Preview shows what shoppers will see as you type. Save with the save bar at the top or the Save button. Other blocks are styled in the theme editor, which has its own live preview, and size charts are created in Shopify admin.
Each block shows its status on Home: Off, On, not added to theme, or Live in theme.
Requirements: the Online Store sales channel, and a theme that supports app blocks (Online Store 2.0) for the blocks you place on product pages. App embeds work with any theme.
Removing old apps: once the Fairloom block is live, turn off the old app's block or embed in the theme editor, then uninstall that app.
The blocks
Announcement bar
App embed · set up in the app
Messages at the top of every page, rotating every 3–30 seconds (default 5). Each message can have a link (a store path such as /collections/sale, or an https:// address).
- Schedule (Essentials and Plus): give a message a start and/or end date and it shows only in that window.
- Countries (Essentials and Plus): pick countries and the message shows only to shoppers browsing in those countries, using your Shopify Markets country selector. Leave empty to show everywhere.
- Free: 1 message · Essentials: up to 5 · Plus: up to 10. On Free, the Schedule and Countries fields show greyed out with an "Essentials plan" badge.
Free-shipping bar
App embed · set up in the app
Shows "You're {remaining} away from free shipping" and fills as the cart grows, then "You've unlocked free shipping". Set a threshold for each currency you sell in (for example USD 50, EUR 45). The bar uses the cart's currency; if there's no threshold for it, the bar stays hidden. Edit both messages in the app; colors in the theme editor.
The bar only displays the message. Set up the free-shipping rate itself in Shopify Settings > Shipping and delivery, using the same amounts.
Trust badges
App block on product pages · set up in the theme editor
A heading, up to three icon badges (secure checkout, delivery, returns, guarantee, sustainable) with your own text, up to three of your own images, and optionally your store's payment icons. Choose icon height and alignment.
Product labels
App block on product pages, plus an optional embed for collection cards · set up in the app
Labels appear when a rule matches:
- Sale: the product has a compare-at price above its price
- New: published within the last N days
- Low stock: inventory at or below a threshold
- Sold out
- Tag (Plus): the product has a tag you choose. On other plans this option shows greyed out with a "Plus plan" badge
Each rule has its own text and colors. To show labels on collection and search pages too, click Show labels on collection cards on Home. Free: 2 rules · Essentials: 5 · Plus: 10.
Some heavily customised themes may need a small CSS tweak for card labels; contact us if they look out of place.
Countdown timer
App block on product pages · set up in the app
Counts down to a sale's real end date. Every countdown needs an end date, and the timer never restarts. You can also set a start date, and limit a countdown to products with certain tags. Free and Essentials: 1 countdown · Plus: up to 10.
Sticky add to cart
App embed on product pages · set up in the theme editor
A bar with the add-to-cart button that stays in view as shoppers scroll. It follows the selected variant and shows "Sold out" when needed. It's on mobile by default; tick Also show on desktop to show it on larger screens. Set colors in the theme editor.
Size chart
App block on product pages · charts created in Shopify admin
Create charts in Shopify admin > Content > Metaobjects > Size chart:
- Title
- Table: one row per line, cells separated by
|, first line is the header (for exampleSize | Chest | Waist) - Notes: optional, such as how to measure
- Product types and Product tags: the chart shows on matching products
To use a specific chart on one product, set the product's Size chart metafield; it overrides type and tag matching.
Delivery estimate
App block on product pages · set up in the app
Shows "Order now and get it between {min} and {max}", calculated from:
- processing days and minimum/maximum transit days
- the cut-off hour (store time zone): orders after it start processing the next shipping day
- the days your warehouse ships
- holidays with no shipping (dates)
It's an estimate based on your settings; keep them in line with how you actually ship.
Low-stock message
App block on product pages · set up in the app
Shows "Only {count} left in stock" when a variant's real inventory is at or below your threshold (default 5). It only appears for products that track inventory in Shopify and are in stock. It reflects the variant selected when the page loads.
Product tabs
App block on product pages · set up in the theme editor
Up to four tabs or FAQ sections with a heading and rich text each, optionally with the first one open. To show different content per product, connect a tab's content to a product metafield (the database icon next to the field in the theme editor).
Plans and billing
| Free | Essentials | Plus | |
|---|---|---|---|
| Blocks | Any 3 | All 10 | All 10 |
| Announcement messages | 1 | 5 | 10 |
| Scheduled and per-country announcements | — | Yes | Yes |
| Label rules | 2 | 5 | 10 |
| Tag-based labels | — | — | Yes |
| Countdowns | 1 | 1 | 10 |
| Support | Priority email |
Prices are on the App Store listing and Shopify's plan page.
- Billing is through Shopify. Charges appear on your Shopify invoice. There are no usage fees and nothing based on your sales.
- Change plan: click Change plan at the top of Home. Shopify handles the switch and any proration.
- What your plan doesn't include is shown, but greyed out with a badge naming the plan you need. Once you've switched on as many blocks as your plan includes, Turn on is greyed out for the rest.
- Downgrading: next time you open the app, your storefront is updated to the new plan's limits. Extra blocks are switched off (in the order listed on Home) and extra messages, rules and countdowns are hidden.
- Nothing you entered is deleted. Dates, countries and tag labels your new plan doesn't include are kept, but not shown on your store. When you save, the app notes "Kept, but not shown on your current plan". Upgrading again brings them back, and you can keep editing everything else in the meantime.
Your data and export
Click Export settings (JSON) on Home to download everything you've set up. The app stores no customer data. See the privacy policy.
Uninstalling
- Optional: export your settings from Home first.
- In Shopify admin, go to Settings > Apps and sales channels, choose Fairloom Essentials and click Uninstall.
What happens:
- All Fairloom blocks and embeds disappear from your storefront. No code is left in your theme.
- Billing stops (Shopify handles the final charge).
- We delete your access tokens straight away, and your settings 48 hours later when Shopify asks us to.
- Size charts live in your Shopify admin as app-owned content. Copy any you want to keep before uninstalling.
Contact
Email [email protected]. Include your store's myshopify.com address and, if it's about how something looks, a link to the page. We reply within 2 business days on the Free plan, 1 business day on Essentials and 8 business hours on Plus. Plus requests are answered first.