Theme app blocks
Every block and its settings, as merchants see them in the theme editor.
Luxe app embed
Body target, required by every block. Theme editor > App embeds > Luxe.
| Setting | Type | Default |
|---|---|---|
| Palette | Theme, Rosewood, Champagne, Obsidian, Eucalyptus, Amethyst | Rosewood |
| Accent, Text on accent, Text, Background, Savings text | Colours, override the palette | Empty |
| Fonts | Luxe or Theme | Luxe |
| Display font, Body font | Font pickers | Crimson Pro, Inter |
| Display style, Display weight | Roman or Italic; 300 to 700 | Roman, 400 |
| Small labels | Uppercase or As written | Uppercase |
| Button | Solid, Outline, Gradient (uses Button gradient) | Solid |
| Button gradient | Gradient, used when Button is Gradient | Empty |
| Uppercase buttons | Checkbox | Off |
| Corners | Sharp, Soft, Round | Soft |
| Set slots | Pill or Square | Pill |
| Badges | Filled or Outline | Filled |
| Hide .00 on whole amounts | Checkbox | On |
| Gift collection | Collection, for live gift stock | Empty |
| Cart trigger selectors, Product card selector | CSS selectors for theme compatibility | Empty |
Bundle set builder
Product template, section target. Renders <luxe-kit-builder> and a no-JS form. Serves build-your-own and fixed sets.
| Setting | Type | Default |
|---|---|---|
| Bundle set | Product, autofilled on the set's own page | Autofill |
| Replace the theme's price and buy buttons | Checkbox | On |
| Compact spacing | Checkbox | Off |
| Review stars | Off, Stars only, Stars and rating, Stars and count, Stars, rating and count | Stars and count |
| Star colour | Text or Accent | Text |
| Item source (Advanced) | Collection, only for sets with more than 128 products | Empty |
Layout (Tiles, Box, Pills, Variant rows, Quantity list), pricing and words are set per bundle set in the app.
Add to bundle set and Tier progress bar
| Block | Settings | Renders |
|---|---|---|
| Add to bundle set | None | <luxe-add-to-kit> on product cards of a collection set; the tray is rendered by the embed |
| Tier progress bar | None | <luxe-set-milestones>: the bar for a collection set with its own tier ladder, when its Tier progress bar position is Top of the page |
Rewards bar
| Setting | Options | Default |
|---|---|---|
| Layout | Full (message, ladder, gift choice) or Slim (one line) | Full |
Upsell blocks
Intended for product templates (not enforced), no settings: offers, products and words come from Upsells in the app.
| Block | Type |
|---|---|
| Often bought together | Frequently bought together |
| Pairs well with | Complete the look: a carousel of 3 to 8 cards |
| Quantity breaks | Multi-pack savings |
| Make it a set | Set price from a product in an active set |
| Refill | Refill pairing |
Upgrade in the set appears inside the Bundle set builder; gift-ready add-ons and the tier gap filler appear in the Luxe cart drawer. Neither needs a block.
Deep links
The app opens the theme editor with the right block already added, for the Bundle set builder, the upsell blocks, the Tier progress bar, Add to bundle set and the Rewards bar, and to turn on the Luxe app embed.