Getting started
Aurelia is designed to be configured from Shopify’s theme editor. You do not need to edit theme code for normal store setup.
Duplicate your current live theme first. Configure and test Aurelia as an unpublished theme, then publish only after storefront checks are complete.
Upload the theme
In Shopify admin, go to Online Store → Themes, add a theme, and upload the Aurelia ZIP file.
Open the editor
Select Customize on the unpublished Aurelia theme. Start with Theme settings before adjusting individual templates.
Connect resources
Assign your main menu, footer menu, products, collections, blog, and any images used by sections.
Review templates
Check the Home, Product, Collection, Search, Cart, Blog, Article, About, Contact, and password templates before launch.
Recommended setup order
- Theme settings: typography, colors, layout, shapes, logo, favicon.
- Header and footer: navigation, search, localization, social links.
- Home page: replace placeholder content and connect store resources.
- Product template: confirm block order, swatches, buy buttons, inventory, pickup, and recommendations.
- Collection and Search: configure filters, sorting, card options, and swatches.
- Cart: test quantity changes, discounts, notes, accelerated checkout, and empty-cart behavior.
- Mobile and desktop QA before publishing.
Theme settings
Global settings control the visual system and store-wide utilities. Open Theme settings from the left side of Shopify’s theme editor.
Typography
Heading font controls display headings. Body font controls paragraphs, controls, labels, and most interface text.
Layout
Choose the Maximum page width and global Page margin to control how open or compact the storefront feels.
Shapes
Set button, input, and card corner radii. Use smaller values for a sharper editorial look or larger values for a softer interface.
Colors
Configure background, text, headings, muted text, accent, surfaces, borders, primary buttons, and secondary button labels.
Brand
Upload the store logo and favicon. Header and footer can optionally use their own logo overrides.
Store utilities
Enable Quick View, free-shipping progress, and the back-to-top control. The free-shipping threshold uses the value entered in this panel.
Social media
Add Instagram, Facebook, Pinterest, TikTok, and YouTube URLs once. The Footer social block uses these global links.
Homepage & section reference
Aurelia includes commerce, editorial, storytelling, social-proof, and media sections. Settings shown below use the same names as the theme editor.
Commerce
Show products from a selected collection with configurable columns, image ratio, vendor, price, badges, color swatches, second-image hover, and Quick Add.
Place a complete product buying experience on another template. Product information is assembled from reorderable blocks including title, price, variants, quantity, buy buttons, inventory, pickup, complementary products, app blocks, and Custom Liquid.
Build a collection directory using flexible cards, image overrides, layout styles, hover zoom, mobile layout, and custom links.
Show products the visitor has recently opened, with card display options and Quick Add.
Show Shopify product recommendations with configurable product-card options.
Editorial & storytelling
Image or video hero system with desktop/mobile heights, autoplay, pagination, arrows, overlays, per-slide mobile images, content positioning, and two CTA styles.
Editorial split layout with desktop and mobile images, image position, content order, alignment, and primary/secondary links.
Flexible text-led section with heading size, alignment, content width, link, colors, and spacing.
Multi-story image composition with selectable layout, story images, text, links, and image positioning.
Full or contained image/video storytelling with autoplay, loop, controls, focal position, overlay, content position, and CTA.
Interactive comparison slider with before/after images, labels, starting position, image ratio, content width, and colors.
Image or video scene with draggable-position-style hotspot coordinates that connect visual points to Shopify products.
Image/video editorial section with material-note blocks, media position, autoplay controls, colors, and footer link.
Step-by-step process storytelling with individual process blocks and a footer note.
Content & trust
Compact icon-and-text benefits with optional links, adjustable row height, mobile layout, and arrow treatment.
Review carousel with ratings, arrows, pagination, and configurable colors.
Brand, press, partner, or certification logos with adjustable maximum logo height and content width.
Flexible content cards with desktop columns, image ratio, optional mobile swipe, and editorial spacing.
Tabbed image-and-text stories with per-tab heading, copy, image, and link.
Accordion-style question and answer blocks.
Show recent articles from a selected blog with excerpt, date, tag, and blog link controls.
Shopify customer signup section with editorial heading, text, and color controls.
Contact layout with intro text, image, contact-info blocks, and Shopify contact form.
Present a location, address, opening hours, and supporting note.
Product pages
The main Product information section is block-based, so merchants can reorder the buying hierarchy without editing code.
Product information blocks
Media gallery
Enable thumbnails, previous/next media buttons, and image zoom. Product media supports Shopify image, video, and supported rich media sources handled by the product media renderer.
Inventory
Set a low-stock threshold and choose whether the remaining quantity should be displayed. Availability updates with the selected variant.
Buy buttons
Choose whether to show the dynamic checkout button and payment terms. The theme also renders Shopify payment-related product information when available.
Pickup availability
Add the Pickup availability block to show location pickup information when local pickup is configured for the product in Shopify.
Complementary products
Add the block and choose how many products to show. Complementary results are requested through Shopify’s product recommendations endpoint.
Sticky add to cart
The separate Sticky add to cart section can show the product image and be enabled independently on desktop and mobile.
Product storytelling sections
Use Product story, Product lifestyle image, Product craft details, and Product details below the core product information to build a longer premium product page without custom code.
Swatches & variants
Aurelia supports Shopify’s native option-value swatch data and also recognizes common color option names for the visual swatch treatment.
Product page swatches
- Add a Variant picker block to Product information or Featured product.
- Turn on Enable swatches.
- Use Shopify product option values with native swatch color or swatch image data for the most accurate result.
- Option names containing Color, Colour, or Szín are also treated as color options by Aurelia.
- Assign different variant media in Shopify if you want the gallery to follow color selections.
Product card swatches
Featured collection, Product grid, Search, and Product recommendations can show color swatches on product cards. Each section has a Show color swatches setting and a swatch limit.
Test products with multiple options such as Color + Size. Aurelia marks unavailable option values and updates the active variant, price, inventory, media, and add-to-cart state as selections change.
Collections & search
Collection and search templates share a consistent product-card system, filtering controls, sorting, swatches, and responsive grids.
Product grid
Configure products per page, desktop/mobile columns, image ratio, sort, product count, filters, filter swatches, card swatches, badges, vendor, second-image hover, and Quick Add.
Editorial collection media
Collection templates can show editorial collection media and choose its layout in addition to the standard title and description content.
Search
Set results per page, columns, filters, sorting, product-card details, swatches, badges, Quick Add, and hover imagery.
Predictive search
Enable predictive search from the Header section. Suggestions appear from the header search interface while the customer types.
The theme renders Shopify storefront filters. Configure the filters available to customers in Shopify’s Search & Discovery settings, then enable filtering in the Product grid or Search section.
Cart & checkout
Aurelia includes both a cart drawer and a full cart page. The cart interface respects Shopify line-item properties, discounts, selling-plan information, unit pricing, tax messaging, and accelerated checkout surfaces when available.
Cart drawer
Customers can review and update the cart without leaving the current page. The drawer includes line-item controls and a summary area.
Cart page
The Cart section includes eyebrow, heading, optional cart note, accelerated checkout buttons, and configurable empty-cart messaging.
Free-shipping progress
Enable it under Theme settings → Store utilities and enter the free-shipping minimum used by your store.
Checkout
Aurelia hands the customer to Shopify Checkout. Payment methods, shipping rates, taxes, Markets behavior, and checkout configuration are managed in Shopify admin.
Images, video & focal points
Aurelia uses responsive Shopify image output throughout the theme. Choose strong source images and use focal points when a section crops media.
- Upload high-resolution source images.
- Set Shopify focal points on images where the important subject is off-center.
- Use dedicated mobile images in sections that provide a Mobile image setting.
- Add a fallback/poster image when using video.
- Preview common desktop and mobile widths before publishing.
- Embedding important text directly into product photography.
- Uploading very small images and stretching them across full-width sections.
- Using autoplay video without checking mobile loading behavior.
- Assuming one crop will work for every aspect ratio.
Video-capable sections
Slideshow, Cinematic media, Shoppable scene, and Material notes include video controls such as autoplay, loop, poster/fallback imagery, and control visibility depending on the section.
Localization
Aurelia uses Shopify’s native localization objects for country/region and language selection.
- Header localizationCountry/region and language controls are available through the header localization interface when multiple choices exist.
- Footer localizationEnable the country/region selector and language selector independently in the Footer section.
- LanguagesPublished store languages and translated content are managed in Shopify. The selector only has multiple choices when more than one language is available.
- MarketsCountry availability, currencies, domains, and market-specific configuration are managed through Shopify Markets.
Apps & Custom Liquid
Aurelia provides native extension points without requiring merchants to edit the theme source.
App blocks
The main Product information and Featured product sections accept Shopify app blocks. Compatible apps can insert their storefront block directly into the product content order.
Apps section
A dedicated Apps section accepts app blocks on templates where Shopify permits the section to be added.
Custom Liquid block
Product information and Featured product include a Custom Liquid block for small merchant-controlled Liquid additions.
Custom Liquid section
A standalone Custom Liquid section includes content-width, full-width side-padding, and vertical-spacing controls.
Custom Liquid and third-party app code can affect layout, performance, and future maintenance. Problems caused by third-party or custom code are outside standard Aurelia theme support.
FAQ
Can I change the fonts and colors without code?
Yes. Typography, the main color system, layout width, page margins, shapes, brand assets, and utilities are available under Theme settings.
Can sections use different colors from the global theme?
Many Aurelia sections include their own Background, Text, and Accent settings. Use section-level colors when you need intentional contrast while keeping the global palette consistent.
Why are country or language selectors not visible?
The selectors only become useful when Shopify exposes more than one available country/region or published language. Confirm your Markets and language configuration in Shopify admin.
Does Aurelia support app blocks?
Yes. Product information and Featured product accept app blocks, and the theme also includes a general Apps section.
Can I use video in the theme?
Yes. Slideshow, Cinematic media, Shoppable scene, and Material notes include video-capable settings.
Where do social links come from?
Add social URLs under Theme settings → Social media. The Footer social media block reads those global settings.
Does theme support include custom development?
No. Standard support covers Aurelia bugs, built-in functionality, and guidance on native settings. Bespoke design changes, third-party app customization, and store-specific development are separate services.
Troubleshooting
Swatches do not appear
Confirm the Variant picker block has Enable swatches turned on. For native visual swatches, add swatch data to Shopify option values. Also confirm the product has more than the default variant.
Quick View / Quick Add is missing
Check Theme settings → Store utilities → Enable quick view, then confirm the relevant product-card section has Show quick add enabled.
Collection filters are empty
Make sure filters are configured for the storefront in Shopify Search & Discovery and that Show filters is enabled in Product grid or Search.
Predictive search does not show suggestions
Open Header settings and make sure both Show search and Enable predictive search are enabled.
Pickup availability is not shown
Confirm the Pickup availability block is present and local pickup is configured for an eligible Shopify location and product.
Product recommendations are empty
Recommendations depend on Shopify’s recommendation data for the current product. The section remains empty if Shopify returns no products.
Localization selectors are missing
Check that more than one country/region or language is actually available to the storefront, then enable the desired selector in Header/Footer settings.
An image crops the wrong area
Edit the image in Shopify and set its focal point where available. For sections with a dedicated image-position setting, adjust that setting as well.
Send us the exact details.
Include the page or template, what you expected to happen, what happened instead, and screenshots.
Changelog
Aurelia 1.0.0
Initial Theme Store release foundation with premium editorial sections, block-based product information, native swatches, responsive product cards, collection/search filtering, predictive search, cart drawer and cart page, localization, rich product media, pickup availability, recommendations, recently viewed products, app blocks, Custom Liquid, and merchant-facing theme settings.