Aevum Theme Documentation
Complete guide to setting up and customizing your Aevum theme.
Getting started
Installation
- In your Shopify admin, go to Online Store > Themes.
- Click Add theme, then choose the Aevum theme from the Theme Store (or upload the ZIP if installing manually).
- Click Customize to open the theme editor.
Choosing a preset
Aevum ships with three presets. Each preset configures colors, typography, and a homepage layout so you can get started quickly. To switch presets, open the theme editor, click Theme settings, and select a preset from the top of the sidebar.
Theme structure overview
The theme is organized into the following directories:
| Directory | Contents |
|---|---|
layout/ | Main layout files (theme.liquid, password.liquid) |
templates/ | JSON templates for every page type |
sections/ | All section files (33 Liquid + 2 JSON section groups) |
snippets/ | Reusable partials (icons, SEO meta, price formatting, etc.) |
config/ | Theme settings schema and preset data |
locales/ | Translation files (English by default) |
assets/ | CSS and JavaScript files |
Presets
Aevum (Default)
A clean, light-toned layout that works well for most stores. Warm off-white backgrounds with dark text. The homepage includes a hero banner, logo strip, product grid, image-with-text storytelling block, testimonials, and a newsletter section.
Midnight
A dark, high-contrast preset for brands that want a bold, premium feel. Deep backgrounds with bright accent text. The homepage features an auto-playing slideshow, featured collection in a square grid, image-with-text block, countdown timer, customer testimonials, and an FAQ section.
Natural
Earthy, muted tones for brands focused on sustainability and organic aesthetics. Sage and warm beige color palette. The homepage includes a hero, product collection, image-with-text block, logo list, community testimonials, and FAQ.
Tip: Presets only set initial values. After applying a preset you can freely change any setting without affecting the preset itself.
Sections
Aevum includes 33 sections. Every section supports a color scheme selector. Sections can be added, removed, and reordered in the theme editor.
Hero
Full-width banner with heading, subheading, and a call-to-action button. Settings include text alignment (left, center, right), height (small, medium, large), overlay opacity, and background image.
Slideshow
Multi-slide hero with autoplay. Each slide is a block with its own heading, subheading, button, and background image. Settings include viewport height (percentage), autoplay toggle, slide speed (seconds), and overlay opacity. Navigation dots meet the 44px touch-target accessibility requirement.
Collection grid
Displays products from a selected collection. Configure products per row (2-5), number of rows, image ratio (portrait, square, landscape), secondary image on hover, vendor name visibility, and quick-add button.
Featured collections
Shows multiple collection cards with titles and images. Useful for guiding shoppers to specific categories.
Image with text
Split layout with an image on one side and text content on the other. Supports "image first" or "text first" layouts. Content is built with blocks: heading, text paragraph, and button.
Rich text
Flexible text section with heading and paragraph blocks. Content width options (small, medium, large) and text alignment (left, center, right). Good for announcements, about pages, or newsletter intros.
Logo list
Horizontal grid of brand logos or trust badges. Each logo is a block with an image picker and optional link. Logo width is adjustable via a range slider (50-200px).
Testimonials
Customer reviews displayed in a responsive grid. Each testimonial block has a star rating (1-5), quote text, author name, and title/role.
Countdown timer
Countdown display showing days, hours, minutes, and seconds until a target date. Includes heading, subheading, and a CTA button. Optional "hide when done" setting to remove the section after the countdown ends.
FAQ
Accordion-style question and answer pairs using the native
Newsletter popup
A popup overlay for email capture. Configurable delay (seconds before showing), heading, body text, and a dismiss cookie duration so returning visitors are not shown the popup repeatedly.
Contact form
Standard contact form with name, email, phone (optional), and message fields. Used on the contact page template.
Custom Liquid
A blank section where you can paste any Liquid code. Useful for embedding third-party widgets or custom markup that does not fit into other sections.
Predictive search
Live search results that appear as the customer types. Displays products, collections, articles, and pages. Fully translated using the theme's locale file.
Product recommendations
Shopify's product recommendations API displayed in a grid below the main product section. Automatically populated based on purchase behavior and product tags.
Complementary products
Shows complementary products defined through the Shopify Search & Discovery app. Appears on product pages when complementary relationships are set up.
Recently viewed
Tracks products the customer has viewed during their session and displays them in a grid. No configuration required beyond color scheme.
Color schemes
Aevum uses five named color schemes plus light and dark defaults. Each scheme defines background, foreground, accent, and button colors. Every section has a color scheme dropdown so you can mix and match schemes across the page.
To edit color schemes, go to Theme settings > Colors in the theme editor. Each scheme has the following fields:
- Background — the section background color
- Foreground — text and icon color
- Accent — links, highlights, and active states
- Button background — primary button fill color
- Button text — primary button label color
Tip: When customizing colors, make sure foreground and background combinations meet WCAG 2.1 AA contrast requirements (4.5:1 for body text, 3:1 for large text and UI elements).
Typography
Typography settings are in Theme settings > Typography. You can choose separate font families for headings and body text from Shopify's built-in font library. Available settings:
- Heading font — used for
h1throughh6 - Body font — used for paragraphs, labels, and UI text
- Body font size — base font size in pixels (14-20px)
- Heading weight — controls whether headings appear normal or bold
- Heading letter spacing — fine-tune heading character spacing
Product pages
The product page is built from the product-main section with configurable blocks:
- Media gallery — supports images, video, 3D models (via Shopify's Model Viewer). Thumbnails can be positioned below or beside the main image.
- Title and price — product title, price, compare-at price, and vendor name.
- Variant picker — radio buttons or dropdown for each option (size, color, etc.).
- Quantity selector — number input with increment/decrement buttons.
- Buy buttons — Add to cart and dynamic checkout button.
- Description — the product's full description rendered as HTML.
- @app blocks — third-party Shopify apps can inject content into the product page through app blocks. These are supported and will render in the order you set in the theme editor.
Below the main product section, you can add Product recommendations, Complementary products, and Recently viewed sections.
Cart
Aevum uses an AJAX cart drawer that slides in from the right side of the screen. The cart updates without a full page reload. Features:
- Line item quantity adjustment
- Line item removal with confirmation
- Cart note field
- Subtotal display
- Checkout button
- Empty cart message with a "Continue shopping" link
Quick-add buttons on collection grids add products to the cart drawer directly without navigating to the product page.
Customer accounts
All standard customer account templates are included:
| Template | Purpose |
|---|---|
| Login | Email/password sign-in with "forgot password" recovery flow |
| Register | New account creation form |
| Account | Order history overview |
| Order | Individual order details |
| Addresses | Manage shipping addresses (add, edit, delete) |
| Activate | Account activation via email link |
| Reset password | Password reset form |
To enable customer accounts, go to Settings > Customer accounts in your Shopify admin and choose "Accounts are optional" or "Accounts are required."
Translations
Aevum ships with a complete English locale file (en.default.json). The theme is fully translation-ready: every visible string uses Shopify's t: translation filter or the theme's JavaScript translation helper.
To add a new language:
- Duplicate
locales/en.default.jsonand rename it (e.g.,fr.jsonfor French). - Translate all string values. Do not change the keys.
- Upload the new file to your theme's
locales/directory.
Alternatively, use Shopify's built-in translation editor under Online Store > Themes > Edit default theme content for quick string changes.
FAQ
How do I change my logo?
Open the theme editor, click on the Header section, and use the logo image picker. You can also adjust the logo width in the same panel.
How do I add a new page to the navigation?
Go to Online Store > Navigation in your Shopify admin. Edit your main menu and add a new menu item pointing to the page, collection, or URL you want.
Can I use more than five color schemes?
The theme supports five custom schemes plus the built-in light and dark options (seven total). If you need more variety, you can use the Custom Liquid section to add inline styles for specific blocks.
How do I set up the countdown timer?
Add the Countdown timer section in the theme editor. Enter your target date in the "End date" field using the format shown in the placeholder (e.g., 2026-12-31T23:59:59). The timer updates in real time.
Do I need to install any apps for the theme to work?
No. Aevum works out of the box without any third-party apps. Product recommendations use Shopify's built-in API. If you use the Search & Discovery app, complementary product relationships will appear automatically.
How do I enable the newsletter popup?
Add the Newsletter popup section in the theme editor. Set the delay (how many seconds after page load before it appears), write your heading and body text, and save. The popup sets a cookie so returning visitors will not see it again for the duration you specify.
Is the theme accessible?
Yes. The theme follows WCAG 2.1 guidelines: proper heading hierarchy, ARIA labels on interactive elements, keyboard-navigable menus and forms, sufficient color contrast, and 44px minimum touch targets on mobile.
Support
For help with the Aevum theme, reach out via email:
contact@lynxcode.fr
We typically respond within one business day.