AMBRE Documentation

Ambre theme guide

Ambre gives your Shopify store the feel of a mobile app: a full-screen home portal, quick add on every product, a sliding cart and a built-in loyalty program. Everything is set up in the theme editor, without code.

Version 1.1.0 · Online Store 2.0 · Works with every Shopify plan

1. Getting started

  1. In your Shopify admin, go to Online Store > Themes and click Customize on Ambre.
  2. Open Theme settings (the brush icon at the bottom left) and choose a Palette.
  3. Upload your logo in Theme settings > Logo: a logo for light backgrounds and a light version for photos and dark backgrounds.
  4. Create your collections in Products > Collections, then add them to the Catalog section on the Collections page.
  5. Click Save. Preview on a phone before you open the store.
Changing the palette or preset replaces your colors and fonts. Write down your custom color codes before you try another one.

2. Presets, palettes and fonts

Ambre comes with four presets, each with its own demo store:

PresetLookMade for
AmbreLight sage, soft serif titlesBeauty, wellness, cosmetics
EpicerieDark cedar and goldFine food, delicatessen
OliveStone and olive greenOlive oil, pantry, organic food
FumoirSmoky blue and copperCoffee, tea, spices, gourmet gifts

Palettes. In Theme settings > Colors, a palette applies all seven store colors in one click: background, text, cards, accent, dark accent, highlight and product image background. There are 15 palettes for beauty, food, fashion, fragrance and sport. Choose Custom to set each color yourself. Button text automatically switches between black and white for contrast.

Fonts. In Theme settings > Typography, choose a heading font and a body font from the Shopify font library. Each palette name suggests a matching heading font.

Layout. Page width, card corner radius and button corner radius are in Theme settings > Layout.

Product images. In Theme settings > Product images, choose Cut-out (transparent PNG placed on the product image background color) or Lifestyle (photo fills the whole card).

4. Home portal

The home page is a full-screen portal: a large image, your logo, a tagline and tiles that lead to the main areas of your store.

SettingTip
Background imageLandscape, at least 2400 px wide, subject on one side
Mobile background imagePortrait (1080 × 1920 px). Otherwise the desktop image is cropped
Image focal pointKeeps the subject visible on small screens
Background and overlay colorThe overlay fades the image into the color; 30–50% keeps text readable
Use palette color as home page backgroundThe home page uses the same background as the rest of the store; logo and text adapt automatically
Show header on home pageShows the menu over the image

Tiles. Add one Tile block per destination (Shop, Our story, Account…). Each tile shows a square image (600 × 600 px) or an icon. A tile can open the customer area or show the customer's points balance. Keep 4 to 6 tiles so they fit on one line on phones.

5. Catalog and collections

Catalog. The Collections page shows all your product ranges on one page. Add one Product range block per collection, in display order. Options: heading, introduction image faded into the page, two-color gradient, paper texture, instant search and products per range.

Collection pages. Filters appear on the side (in a drawer on phones) with sorting. Results update without reloading and active filters appear as removable chips. Price and availability are always available; add more filters in Search and Discovery > Filters.

Promo card. Insert a promo card into the product grid with a Promo card block: image or color, heading, button and position.

Product cards. Each card shows the price (and unit price when set), loyalty points, and a + button that opens quick add with variants, color swatches and quantity.

6. Product page

The product information column is made of blocks you can reorder, hide or duplicate:

BlockWhat it does
Vendor, HeadingBrand and product title
PricePrice, compare-at price, unit price, tax and shipping notice, and the Shop Pay Installments banner
Loyalty pointsPoints earned with this variant
TaglineFirst paragraph of the description
Buy buttonsVariants and color swatches, subscriptions, gift card recipient form, size guide, low-stock notice, countdown, quantity, add to cart and dynamic checkout buttons
Pickup availabilityLocal pickup status per location (when local pickup is enabled)
Trust badges, Text, Collapsible rowFree content, or the content of a page
Collapsible descriptionEach heading 4 in the product description becomes a collapsible row
Custom Liquid, AppsYour own code or app blocks (reviews, bundles…)

Media. The gallery supports images, Shopify-hosted videos, YouTube and Vimeo videos, and 3D models with View in your space on compatible phones.

Subscriptions. Install a subscription app (for example Shopify Subscriptions). Purchase options appear automatically, the price updates, and the plan name is shown in the cart.

Gift cards. On gift card products, customers can send the card to a recipient by email, with a message and a send date.

Sticky add to cart bar. A bar with image, price and button appears when the main button scrolls out of view.

Never show a fake stock level or a fake countdown. The low-stock notice uses real inventory tracked by Shopify, and the countdown hides itself at the real end date you enter.

7. Cart and delivery

Choose a drawer (recommended) or a cart page in Theme settings > Cart and delivery.

  • Free shipping bar — shows the amount left before free shipping. Use [amount] in the text for the remaining sum. The threshold must match your free shipping rate in Settings > Shipping and delivery.
  • Suggestions — up to 6 complementary products added in one click, from Shopify recommendations, with a fallback collection.
  • Order note — a collapsible gift message field, saved as the customer types.
  • Delivery slots — customers pick a day and a time slot. They appear in the order under Additional details. Slots are indicative and never block checkout.

8. Loyalty points

The loyalty program is off by default. Turn it on in Theme settings > Loyalty. The theme displays points on product cards, product pages, the cart and the customer area, and calculates conversions. It does not credit points by itself.

SettingExampleEffect
Points namePointsUsed everywhere
Points per currency unit11 point per unit spent
Currency value of 100 points5100 points are worth 5
Redemption step500Customers redeem in steps of 500 points
Discount code prefixPOINTSCodes are named POINTS25, POINTS50…
TiersMember:0,Silver:1000Tier name and total spent threshold
  1. Create the discount codes in Discounts: one fixed-amount code per possible step, named prefix + amount.
  2. Create the balance field in Settings > Custom data > Customers: namespace and key custom.points, type integer.
  3. Credit points after each order with Shopify Flow or a loyalty app, or edit the field on the customer page. Remember to remove redeemed points.

Per-variant points can be forced with the variant metafield custom.points.

9. Page templates and sections

Create a page in Online Store > Pages and choose its template:

  • page.contact — contact form (name, email, phone, message). Messages arrive at your store email.
  • page.rituels (Rituals) — two tabs: routines (a list of products added to cart in one click) and services with a booking link.
  • page.club — presents the loyalty program, tiers and benefits.
  • page.histoire (Our story) — image with text, promise, reviews and FAQ.

Sections you can add anywhere: Rich text, Image with text, Image banner, Featured collection, Product videos, Customer reviews, FAQ, Email signup, Apps and Custom Liquid.

Only publish real customer reviews.

10. Languages and accessibility

Ambre is translated into English and French, storefront and editor. Edit any theme text in Online Store > Themes > … > Edit default theme content. For a multilingual store, add languages in Settings > Languages, assign them to your domain, and translate content with Translate & Adapt. A language selector appears in the header automatically.

The theme supports keyboard navigation with visible focus, reduced motion, accessible color contrast and screen reader labels. Add alt text to every image. Customers can install your store on their home screen from their phone browser.

11. FAQ

Why don't I see the Shop Pay Installments banner or the Follow on Shop button?

They only appear when Shop Pay and Shop Pay Installments are enabled in Settings > Payments, and in a supported country and currency.

Pickup availability doesn't show.

Enable local pickup for at least one location in Settings > Shipping and delivery > Local pickup, and make sure the product is stocked there.

Loyalty points don't increase after an order.

The theme only displays points. Credit the custom.points customer field with Shopify Flow, an app or by hand.

The free shipping bar promises free shipping but checkout charges it.

The bar amount and your free shipping rate in Settings must be identical, in the same currency.

How do I get color swatches?

Choose a Shopify product category, then set colors or images on the option values. You can also use the shopify.color-pattern metafield.

How do I add an app block?

On the product page, click Add block in the product information section and pick the app. On other pages, add the Apps section.

How do I make a collapsible product description?

In the product description, use Heading 4 for each part (Benefits, How to use…). Each heading becomes a collapsible row.

Can I update Ambre without losing my settings?

Yes. Add the new version from the Theme Store: Shopify copies your settings and content. Code edits you made yourself are not copied.

12. Support policy

  • Response time: within 2 business days (Monday to Friday, Paris time), in English or French.
  • Included: help with theme settings and features, bug fixes, and guidance on compatible apps.
  • Not included: custom code changes, third-party app issues and store design work. These can be quoted separately.
  • Updates: bug fixes and new features are free for the life of the theme.

Contact support

13. Release notes

1.1.0

  • Product page built from blocks, with app blocks and Custom Liquid.
  • New: unit prices, pickup availability, subscriptions, Shop Pay Installments, gift card recipient form, 3D models and videos in the gallery.
  • New sections: Email signup, Apps, Custom Liquid; new contact page template; Follow on Shop in the footer.
  • Editor fully translated (English and French); palette switcher translated.
  • Faster pages: section stylesheets load only where needed and the first product images load first.
  • Accessibility: visible focus, larger touch targets, better contrast.
  • Four presets: Ambre, Epicerie, Olive and Fumoir.

1.0.0

  • First release: home portal, catalog, quick add, cart drawer, loyalty points, rituals and 15 palettes.