Documentation · Version 1.0.0
Documentation
Everything Aurelle does, section by section. Search below, or follow the contents.
On this page
Overview
Aurelle is a minimal, high-luxury Online Store 2.0 theme for premium skincare and beauty brands. It installs with a complete, neutral homepage and footer, and three presets (Quiet Luxury, Clinical Skincare, Botanical & Organic) that restyle everything in one click.
01
Getting started
- Add the theme to your store (upload the theme file, or install it from the Theme Store) and open Customize.
- Choose a preset in the theme editor (Theme settings, theme style). A preset changes colors, fonts, buttons, corners and spacing. It does not change your content.
- Add your logo, then replace the placeholder images in the homepage sections.
- Check your navigation menus (see "Navigation") and the sections listed in "Before you launch" at the end of this page.
The homepage is a neutral base on purpose: its wording works with every preset, so you can switch presets at any time without rewriting anything.
02
Presets
| Preset | Look | Best for |
|---|---|---|
| Quiet Luxury | Cream, black and beige, elegant serif, generous whitespace, sharp corners | Premium cosmetics brands |
| Clinical Skincare | White, cool grey and pastel blue, technical sans-serif, compact spacing | Dermatological and pharmacy-grade skincare |
| Botanical & Organic | Warm earth, sage and olive, natural serif, soft rounded corners | Organic and plant-based beauty |
Two alternative homepage layouts are included as templates, index.clinical and index.botanical, with copy and section order suited to those niches. Preview them by adding ?view=clinical or ?view=botanical to your homepage address. Copy a layout into the default homepage if you want to use it.
03
Homepage and section library
Every section has an app block slot, a heading you can edit, and (where it makes sense) blocks you can add, remove and reorder.
| Section | What it does |
|---|---|
| Hero | Image and text split, with a button |
| Autoplay video | Muted looping background video with heading and button. Always has a pause button, and pauses for visitors who prefer reduced motion. Upload a short silent clip (under 10 MB) and set a fallback image |
| Featured collection | Product grid from a collection, with optional quick add |
| Collection list | Category tiles from up to seven collections |
| Image with text | Image beside text, image on either side, three image shapes |
| Icon benefits | Short promises with a simple icon, one block each |
| Logo list | "As featured in" or partner logos, optional grayscale |
| Testimonials | Customer quotes with star rating and photo. Scrolls sideways on mobile, grid on larger screens |
| Before and after slider | Drag or use the arrow keys to compare two images |
| Shoppable image | Lifestyle image with product pins. Each pin opens a card with Add to cart. Pins appear once you choose a product for each pin block |
| FAQ | Accordion of questions. Can open one at a time, and adds FAQ structured data for search engines |
| Journal | Latest blog posts (see "Blog") |
| Promo countdown | Offer banner with a timer. Use the date format 2026-12-31T23:59:00-05:00 |
| Newsletter | Email sign-up band |
| Rich text | Centered heading, text and button |
05
Collection pages
- Filters use Shopify's native filtering. Set up the filters you want (availability, price, product type, and a "skin type" filter from a product metafield or tag) in the Shopify Search & Discovery app. The theme shows whatever you configure.
- Sorting, active-filter chips and "Clear all" update the page without reloading.
- Quick add puts an Add to cart button on every product card. Products with several variants reveal a small variant selector. Switch it off per section.
06
Product pages
Product page blocks can be reordered or removed in the editor:
- Variant picker with swatches: options named in the block setting (Color, Shade, Texture and similar) are drawn as swatches. Colors come from the "Swatch colors" setting, one per line as
Rose: #C48B7B. Values without a color use the variant's photo, otherwise a normal button. - Low stock warning: shows "Only N left in stock" at or below a threshold you set, with an optional bar. It needs inventory tracking turned on for the variant.
- Trust badges: four short claims, each with an icon.
- Ingredients and How to use accordions: fill the product metafields
custom.ingredientsandcustom.how_to_use, or type the content into the block. - Frequently bought together and You may also like: the Product recommendations sections use Shopify's recommendations. Set complementary products in Search & Discovery. If there are none, the section stays empty and invisible.
- Sticky add to cart on phones, and dynamic checkout buttons (shown if enabled in your payment settings).
07
Cart
The cart opens as a drawer without leaving the page.
- Free shipping progress bar: set the threshold in Theme settings, Cart.
- Product suggestions: up to two complementary products (from Search & Discovery) or, if there are none, the collection chosen in the Cart drawer section.
- Discount code field and order note: both can be switched off in Theme settings, Cart. Some codes, such as free-shipping codes, are verified only at checkout, and the drawer says so.
08
Blog
The Blog page and the Journal section show neutral sample posts until your blog has its first article, then switch to your real articles automatically. Edit, add or remove the samples in the section, or switch them off.
09
Privacy and compliance
- Cookie banner (section "Cookie banner"): appears only where Shopify's Customer privacy settings require consent. If you also use Shopify's built-in banner, turn one of them off.
- Exit-intent popup (section "Exit-intent popup"): off by default. When on, it appears only on desktop, after a delay, at most once every few days, never on the cart or account pages.
- Structured data (JSON-LD): Organization and WebSite on the homepage; breadcrumbs on product, collection, article, blog and page templates; CollectionPage, BlogPosting, ContactPage; Product (from Shopify) and FAQPage. Add your logo and social links in Theme settings to complete the Organization data.
- Accessibility: built toward WCAG 2.1 AA: keyboard operable menus, drawers and dialogs, visible focus, labelled forms, and respect for reduced motion. Check your own content (image descriptions, color choices) too.
10
Theme settings
| Group | What you control |
|---|---|
| Colors | Background, surface, accent, text, muted text, borders, button, sale price, badge, announcement bar and footer colors |
| Typography | Heading and body fonts, base size, heading size scale, capitalization and letter spacing, line height |
| Layout | Page width, corner radius, bottom navigation on phones, section spacing, product card image shape, vendor on cards |
| Buttons | Solid or outline, corner radius, capitalization, letter spacing |
| Cart | Free shipping threshold, suggestions, discount field, order note |
| Social media | Profile links, shown in the footer and in structured data |
| SEO & structured data | Organization logo and a fallback meta description |
| AI chatbot | Accent color and spacing for a chat widget installed as an app embed |
| Favicon | Browser tab icon |
11
Account, password and gift card pages
All customer account pages are included (login, register, account, orders, addresses, password reset, account activation), plus a password page, a gift card page with a QR code, a contact page with a form, an About page template and a FAQ page template. Assign the page templates to your own pages from the page editor in Shopify admin.
12
Before you launch
- Replace placeholder images and logos, and add your video.
- Write your Terms, Privacy, Refund and Shipping policies in Settings, Policies. They appear in the footer.
- Check the footer links and your navigation menus.
- Create at least three blog articles, or keep the samples until you do.
- Set the free shipping threshold in your store's currency.
- Add a Contact page and a FAQ page, and assign the templates.
13
Customization
All colors, fonts and spacing come from CSS variables set in Theme settings. Prefer the settings over editing code. If you edit code, keep changes in your own copy of the theme and re-apply them after updates.
14
Troubleshooting
- A filter I need is missing: add it in the Shopify Search & Discovery app.
- The country selector is missing: your store sells in one country and one language.
- Suggested products do not appear in the cart: set complementary products in Search & Discovery, or choose a collection in the Cart drawer section.
- The cookie banner does not show: consent may not be required for the visitor's region, or consent was already given.
- Low stock never shows: turn on inventory tracking for the variant.
Changelog
1.0.0
Initial public release.
- Three presets: Quiet Luxury, Clinical Skincare and Botanical & Organic, plus two alternative homepage layouts.
- Neutral, complete default homepage, footer and sample journal posts.
- Collection filters with active-filter chips, quick add, and product swatches, low-stock warning, trust badges and cross-sell on product pages.
- Cart drawer with free shipping progress, product suggestions, discount code field and order note.
- Mega menu, instant-search overlay, country and language selector.
- Section library: hero, autoplay video, featured collection, collection list, image with text, icon benefits, logo list, testimonials, before and after slider, shoppable image, FAQ, journal, promo countdown, newsletter.
- Cookie banner, optional exit-intent popup, complete JSON-LD structured data.
- All customer account, password, gift card, blog, article and contact templates.