Shopify Theme Documentation

Eira — Premium Cosmetic Theme

A complete reference for every setting, section, and feature in the Eira Shopify theme. Built for beauty and skincare brands who care about design, performance, and conversion.

Shopify OS 2.0 Section Rendering API No jQuery WCAG 2.1 AA Core Web Vitals Ready

Install & Launch Eira

Follow these five steps to install the theme, import demo content, complete first-time setup, connect required apps, and go live.

Step 1 — Install the Theme

  1. 1
    Purchase and download Eira from the Shopify Theme Store or your purchase receipt.
  2. 2
    In Shopify Admin, go to Online Store → Themes.
  3. 3
    Click Add theme → Upload zip file and upload the downloaded .zip file.
  4. 4
    Once uploaded, click Customize to begin setup, or Publish to make it your live theme.
Tip: Always keep the previous theme as a backup before publishing a new one.

Step 2 — Import Demo Content (Optional)

Eira includes a demo content importer that sets up sample pages, navigation menus, and sections to match the theme preview.

  1. 1
    In the Theme Editor, click Actions → Import demo content.
  2. 2
    Select the demo preset that matches your store style.
  3. 3
    Click Import — existing content is not overwritten.

Step 3 — First-Time Setup Checklist

Complete these steps in the Theme Editor (Online Store → Themes → Customize):

  • Upload your logo — Theme Settings → Header → Logo
  • Set brand colours — Theme Settings → Colors → Brand palette
  • Set typography — Theme Settings → Typography
  • Configure header — layout, sticky behaviour, transparent header
  • Build your navigation menus — Shopify Admin → Navigation
  • Set up the footer — columns, newsletter, social links, payment icons
  • Configure the announcement bar — promo messages and countdown
  • Set up the cart — Drawer or Page mode, free shipping threshold
  • Add Homepage sections — Hero Banner, Featured Products, Testimonials
  • Enable Quick View & Wishlists — Theme Settings → Product Cards
  • Configure product page — tabs, size guide, trust badges
  • Set up collection filters — install Search & Discovery app first
  • Add social media links — Theme Settings → Social Media
  • Set favicon — Theme Settings → Favicon
  • Test on mobile — use the mobile preview in the Theme Editor

Step 4 — Connect Required Apps

FeatureApp Required
Collection filters by tag/metafieldShopify Search & Discovery (free)
Product reviews & star ratingsShopify Product Reviews or Judge.me
Email newsletter signupKlaviyo, Mailchimp, or Shopify Email
WishlistSwym Wishlist Plus or Growave

Step 5 — Go Live

  1. 1
    Remove the password page — Shopify Admin → Online Store → Preferences → uncheck password protection.
  2. 2
    Connect your custom domain — Settings → Domains.
  3. 3
    Set up payment methods — Settings → Payments.
  4. 4
    Enable shipping rates — Settings → Shipping and delivery.
  5. 5
    Test a complete purchase using Shopify's Bogus Gateway test payment method.

Theme Settings

Theme Settings control global design across your entire store — colors, typography, buttons, product cards, animations, and more. Access via Theme Editor → Theme Settings (paintbrush icon).

Theme Settings

Colors

Eira uses Color Schemes — up to 6 pre-defined background + text + button color combinations. Changing a scheme instantly updates every section assigned to it.

SettingWhat it does
Scheme 1–6Edit background, text, button, and link colors for each scheme
Primary ButtonBackground and text color for solid CTA buttons
Secondary ButtonBorder and text color for outline-style buttons
Tip: Use Scheme 1 for light sections, Scheme 2 for a soft tint (light pink/beige), and Scheme 4 for dark sections like the footer.

Typography

SettingWhat it does
Heading FontTypeface used for all H1–H4 headings across the store
Body FontTypeface used for paragraphs, labels, and navigation
Heading Size ScaleA multiplier that makes all headings larger or smaller globally
Body SizeBase font size for body text (px)
Heading ItalicWhen on, headings are styled in italic — a signature Eira aesthetic
Letter SpacingAdjusts tracking on headings (useful for uppercase heading styles)

Buttons

SettingWhat it does
Border RadiusHow rounded button corners are (0px = square, 50px = pill)
Button StyleFilled (solid) or Outlined (border only) for secondary buttons

Product Cards

SettingWhat it does
Image RatioSquare, Portrait (3:4), or Natural (original ratio)
Show Second Image on HoverSwaps to the second product image on hover
Show Quick AddAdd to Cart button appears on card hover
Show VendorDisplays the product's brand/vendor name on the card
Show RatingShows star rating (requires compatible reviews app)
Sale Badge StyleText (Sale), Percentage (–20%), or Amount (–$10)

Cart

SettingWhat it does
Cart TypeDrawer (slide-out panel), Page (dedicated cart page), or Popup
Enable Cart NoteLets customers leave an order note from the cart

Social Media

Fill in your social media profile URLs here — used across the theme wherever social icons appear (footer, announcement bar, mobile menu).

PlatformField
Instagraminstagram_link
TikToktiktok_link
Facebookfacebook_link
Pinterestpinterest_link
YouTubeyoutube_link
Twitter / Xtwitter_link

Animations

SettingWhat it does
Enable AnimationsGlobal toggle for all scroll-triggered entrance animations
Animation StyleFade Up, Fade In, or Slide In

Favicon

Upload your store's favicon under Theme Settings → Favicon. Use a square PNG or SVG, minimum 32×32px. A 512×512px file is recommended.

Customisation Guide

Custom CSS, Custom Liquid, section limits, metafields, and color swatch configuration — for merchants and developers who need to go beyond the Theme Editor.

Custom CSS

Eira provides a Custom CSS input in the Theme Editor for adding CSS overrides without editing theme files.

  1. 1
    Go to Online Store → Themes → Customize.
  2. 2
    Click Theme settings (bottom of the left panel).
  3. 3
    Scroll to Custom CSS and paste your CSS rules.

Eira exposes CSS custom properties for consistent overrides:

:root {
  --color-brand: #D4A0A0;   /* primary brand colour */
  --color-accent: #8B4B6B;  /* accent / button colour */
  --font-heading: 'Cormorant Garamond', serif;
}
Tip: Use !important sparingly — it makes future maintenance harder. Always test on mobile after adding CSS.

Custom Liquid (Additional Scripts)

For adding JavaScript or Liquid that runs on every page, go to Theme Settings → Custom code and use the Header or Footer script fields. For complex edits, use Edit code (Online Store → Themes → Actions → Edit code).

⚠ Important: Always duplicate your theme before editing code directly. Go to Actions → Duplicate to create a backup.

Section Limits

Shopify enforces a limit of 25 sections per template. Blocks within a section have a separate limit — typically 16–50 blocks depending on the section type.

Metafields

Metafields let you attach custom data to products, collections, customers, and orders — then display that data in your theme.

  1. 1
    Go to Shopify Admin → Settings → Custom data.
  2. 2
    Select the resource (Products, Collections, etc.) and click Add definition.
  3. 3
    Set name, namespace, key, and type — then add values to individual products/collections.

Common cosmetic use cases for Eira's Product metafield blocks:

Metafield KeyDisplay Use
product.metafields.custom.skin_typeBest for: Dry, Oily, Combination
product.metafields.custom.key_ingredientsIngredient callouts
product.metafields.custom.how_to_useStep-by-step usage instructions

Color Swatches Configuration

Colour swatches are generated automatically from variant option values. To control which option names trigger swatch rendering:

  1. 1
    Go to Theme Settings → Product → Swatch option names.
  2. 2
    Enter a comma-separated list of option names, e.g. Color, Colour, Shade, Finish.
  3. 3
    Upload swatch images to Settings → Files — name each file exactly after the variant value (e.g. rose-gold.png).

Mega Menus

Mega menus are large dropdown panels that open from top-level navigation items. Eira supports 3 layouts, each configured as a block inside the Header section.

Mega Menu Settings

How Mega Menus Work

Mega menus are powered by two things: (1) a Shopify menu item with children, and (2) a Mega Menu block in the Header section linked by matching its title. When both exist and the title matches, Eira replaces the standard dropdown with the rich mega menu panel.

Setting Up — Step by Step

  1. 1
    Go to Shopify Admin → Navigation → Main Menu and add child links under a top-level item.
  2. 2
    In the Theme Editor → Header, click Add block → Mega Menu.
  3. 3
    In Menu Item Title, type the exact name of your top-level link (case-insensitive), e.g. Shop.
  4. 4
    Choose a layout and fill in the layout-specific settings.

Layout 1: Columns + Products

Navigation links as columns on the left, product cards from a collection on the right. Product cards show image, title, price, and an AJAX Add to Cart button.

SettingWhat it does
Menu Item TitleMatches this block to a top-level nav link
Products CollectionCollection to pull product cards from (up to 4)
Featured ProductPin one specific product as the first card
Products to ShowHow many product cards to display (1–4)

Layout 2: Columns + Promo Image

Navigation columns on the left, a promotional image card with title, subtitle, and button on the right. The Promo Image also appears at the top of the mobile accordion for that nav item.

SettingWhat it does
Promo ImageThe promotional photo shown on the right side
Promo TitleBold text over/below the promo image
Promo SubtitleSupporting text
Promo Button LabelCTA text, e.g. Shop Now
Promo Button LinkWhere the button links

Layout 3: Collection Cards

Child menu links displayed as visual collection image cards. Each collection must point to a Collection page for its image to load.

SettingWhat it does
Cards Per RowHow many collection cards show in a row (2–5)
Show Product CountDisplays the number of products under each card

Interaction Behaviour

TriggerWhat happens
Mouse hover over nav itemMega menu opens after 150ms delay
Mouse leaves nav item or panelMega menu closes after 150ms delay
Keyboard: Arrow Down on triggerOpens the mega menu, moves focus into panel
Keyboard: Escape inside panelCloses the mega menu, returns focus to trigger
Click outside the headerCloses all open mega menus

Cart Drawer

The Cart Drawer is a slide-in panel that opens when a customer clicks the cart icon. It's the recommended cart mode for Eira — customers review items and checkout without leaving the current page.

Enabling the Cart Drawer

  1. 1
    Go to Theme Editor → Theme Settings (paintbrush icon).
  2. 2
    Open the Cart group.
  3. 3
    Set Cart Type to Drawer.
Cart Drawer Settings

Cart Drawer Settings

SettingWhat it does
Cart TypeDrawer (recommended), Page, or Popup
Show Cart RecommendationsShows a "You may also like" strip at the bottom
Recommendations SourceAutomatic (Shopify AI) or a specific collection
Show Free Shipping Progress BarShows progress bar toward free shipping threshold
Free Shipping ThresholdCart total at which free shipping unlocks
Show Order NoteAdds a text field for personalisation/gift notes
Pro Tips
  • Always use Cart Drawer mode — it keeps customers on the page and reduces drop-off.
  • Enable the Free Shipping Progress Bar if you offer free shipping at any threshold — it consistently increases average order value.
  • Use Order Note if you offer personalisation or gift wrapping.
  • Keep Cart Recommendations on — customers in purchase mode are likely to add impulse items.

Quick View

Quick View is a modal overlay letting customers preview full product details — images, variants, description, and Add to Cart — without leaving the current page. Opens from product cards across all pages.

How to Enable

  1. 1
    Go to Online Store → Themes → Customize.
  2. 2
    Open Theme Settings → Product Cards.
  3. 3
    Toggle Enable Quick View to ON.
Quick View Settings

Quick View Modal Contents

ElementDetails
Product ImagesFull gallery with thumbnail strip — swipeable on mobile
Title & PriceLive price update when variant changes
Variant SelectorsColour swatches + dropdown selectors
Quantity SelectorIncrement/decrement with min/max guard
Add to CartAJAX add — confirms with toast, updates cart count badge
View Full DetailsLink to the full product page
Short DescriptionFirst paragraph of product description (configurable)

Behaviour

Modal opens with a smooth fade + scale animation. Closing: click ✕, click outside, or press Escape. Focus is trapped inside the modal (WCAG 2.1 AA compliant). On mobile, the modal slides up as a bottom sheet. Quick View content is fetched via the Section Rendering API on demand — zero performance cost until triggered.

Customer Accounts

Eira supports both Classic customer accounts and Shopify's newer New customer accounts.

Classic vs New

FeatureClassicNew
Login methodEmail + PasswordMagic link or Google/Apple SSO
RegistrationManual formAuto-created on first login
Theme customisationFull — uses Eira's sectionsLimited — Shopify-hosted
Requires passwordYesNo — passwordless
Recommendation: New customer accounts are strongly recommended for new stores — the passwordless flow dramatically reduces login friction and abandoned carts from forgotten passwords.

Classic Account Pages

PageURL
Login/account/login
Register/account/register
Account Dashboard/account
Order Detail/account/orders/{id}
Addresses/account/addresses

Announcement Bar

The thin strip above your header, visible on every page. Rotate up to 5 different messages automatically. Found at: Theme Editor → Announcement Bar.

Header Section Settings

Settings

SettingWhat it does
Color SchemeBackground and text color of the bar
Bar HeightHow tall the bar is in pixels
Autoplay SpeedSeconds each message shows before the next slides in
Show Social IconsShows social media icons on the right side of the bar
Show Language / CurrencyShows language and currency selector for international stores

Announcement Blocks

FieldWhat to enter
MessageThe text in the bar, e.g. Free shipping on orders over $75
Button TextOptional clickable button, e.g. Shop Now
Button LinkWhere the button links

Header

The header appears on every page. It holds your logo, navigation menu, search, account, and cart icons. Found at: Theme Editor → Header.

Header Section Settings

Layout

SettingWhat it does
Menu StyleLogo Left, Logo Center, or Logo Right
Enable Sticky HeaderHeader stays fixed at the top as customers scroll
Transparent Header on HomepageHeader overlays hero image with no background on homepage only

Logo

SettingWhat it does
Logo ImageUpload your store logo. Empty = store name as text
Logo Width — DesktopHow wide your logo renders on desktop
Logo Width — MobileHow wide your logo renders on phones
Image tip: Upload your logo at double the width you set. For a 120px Logo Width, upload a 240px-wide file for sharp retina display.

Search

SettingWhat it does
Search Placeholder TextHint text inside the search input box
Popular Search TermsComma-separated terms shown as quick-tap shortcuts
Header HeightHow tall the header bar is

Hero Banner

The large full-screen section at the top of your homepage. Have a single slide or up to 6 slides with background image, video, text, and CTA buttons. Found at: Theme Editor → Hero Slider.

Banner Settings

SettingWhat it does
Banner HeightHeight as % of screen. 100 = full screen, 50 = half screen
Auto-rotate SlidesAutomatically cycles through slides
Slide DurationSeconds each slide shows before moving to next

Slide Block Fields

FieldWhat to enter
Background VideoUpload an MP4 file — plays silently on loop. Add poster image as mobile fallback
Background ImageMain photo that fills the slide (also used as video poster/fallback)
Mobile ImagePortrait-format image for phones. Highly recommended
Overlay OpacityDark layer over image for text readability (0–90%). Start with 15–40%
SubtitleSmall text above the main heading
HeadingMain large headline — keep to 4–6 words for hero impact
Button LabelCTA text, e.g. Shop Now
Button LinkWhere the button takes the customer
Text ColorColor of subtitle, heading, and button on this slide
Horizontal / Vertical PositionWhere text sits on desktop and mobile
Best Practice: Always add a Mobile Image — landscape hero photos rarely look good cropped to portrait on a phone. Upload a dedicated vertical version.

Products Section

A scrollable row or grid of product cards. Highlight best sellers, new arrivals, or any collection. Add collection tabs for customers to filter between categories without leaving the page.

Content Settings

SettingWhat it does
Section HeadingTitle above the products, e.g. Best Sellers
Italicize HeadingMakes heading italic for an editorial look
CollectionCollection to pull products from (used without Collection Tab blocks)
Products to ShowHow many products to display (2–12)
Desktop Columns2, 3, or 4 columns on desktop. Mobile always 1 per row

Collection Tab Blocks

Add up to 6 Collection Tab blocks. Each tab shows a different set of products. When at least one tab is added, an All tab appears first automatically.

FieldWhat to fill in
CollectionThe collection whose products appear when this tab is selected
Tab LabelText shown on the tab button. Blank = uses collection title
Products to ShowHow many products to show under this tab (2–12)

Collection List

A grid of collection cards — each showing the collection's image, name, and optional product count. Use on your homepage or a dedicated categories page. Found at: Theme Editor → Add section → Collection List.

SettingWhat it does
Section HeadingTitle above the cards, e.g. Shop by Category
CollectionsChoose which collections to display
Show Product CountNumber of products under each collection card
Columns (Desktop)Cards per row on desktop
Card StyleOverlaid — name on image; Below — name under image
Image RatioSquare, Portrait (3:4), or Landscape (4:3)
Required: Each collection must have a Featured Image set in Shopify Admin, otherwise the card shows a placeholder.

Testimonials

Customer reviews or quotes in a scrollable carousel. Build trust and social proof anywhere on your store. Found at: Theme Editor → Add section → Testimonials.

FieldWhat to fill in
QuoteThe customer's review text
Customer NameReviewer's name, e.g. Sarah M.
Customer Title / LocationOptional context, e.g. Verified Buyer or London, UK
Star RatingSelect 1–5 stars
Customer PhotoSmall avatar or portrait of the reviewer
Tips
  • Use real customer language — genuine-sounding testimonials convert better.
  • Include first name and last initial (Sarah M.) for credibility without exposing full details.
  • Add at least 6 testimonials so the carousel feels varied.
  • Prioritise reviews mentioning a specific result over vague praise.

Newsletter

A dedicated email signup panel. Capture subscribers with a discount code, early access, or skin tips. Found at: Theme Editor → Add section → Newsletter.

SettingWhat it does
Section HeadingMain headline, e.g. Get 10% Off Your First Order
SubtextSupporting description
Button LabelSubmit button text, e.g. Subscribe or Claim My Discount
Success MessageText shown after a successful signup
Show Name FieldAdds a first name field next to the email input
Background ImageOptional full-width background photo
Converting tip: "Get 10% off your first order" massively outperforms "Subscribe to our newsletter." Always use a specific offer in the heading.

Sale Banner

A bold, high-impact promotional section for limited-time sales. Features a countdown timer, headline, offer details, and CTA button. Found at: Theme Editor → Add section → Sale Banner.

SettingWhat it does
Badge / Tag TextSmall label above heading, e.g. Limited Time or Flash Sale
HeadingMain offer headline, e.g. Up to 40% Off Sitewide
Enable CountdownShows a live countdown timer
End Date & TimeWhen the countdown reaches zero
Expired MessageText shown after countdown reaches zero
Background ImageFull-width photo behind the banner content
Always set an End Date for the countdown — a sale with no deadline feels permanent and loses urgency.

Brand Features

Highlight key selling points: Clean Ingredients, Dermatologist Tested, Cruelty Free, Sustainable Packaging. Each feature shows an icon, heading, and short description. Found at: Theme Editor → Add section → Brand Features.

Feature Block FieldWhat to fill in
Icon / ImageUpload a small PNG icon or illustration (SVG works best for crispness)
HeadingThe feature name, e.g. Cruelty Free
Description1–2 sentences expanding on the feature
Tip: Use 4 features as a default — it fills a desktop row perfectly and collapses to 2 columns on mobile.

Before & After

An interactive drag-slider comparison of two images — perfect for demonstrating skincare results. Customers drag a handle left or right to reveal more of each image. Found at: Theme Editor → Add section → Before & After.

SettingWhat it does
Before ImageThe "before" photo (left side)
After ImageThe "after" photo (right side)
Before LabelText shown over the before image
After LabelText shown over the after image
Initial Handle PositionWhere the drag handle starts (0–100%). 50 = centered
Required: Both images must be the same size and framing — the slider only works as a convincing comparison when the subject is in the same position in both photos.

Product Page

Where customers make their purchase decision. Shows images, title, price, variant selector, Add to Cart button, description, and customisable content blocks. Found at: Theme Editor → Products → Default Product.

Media Settings

SettingWhat it does
Media LayoutStacked / Thumbnails / Sticky
Enable Image ZoomCustomers can click/tap to zoom in
Enable Video AutoplayProduct videos autoplay when in view (muted)

Product Info Blocks

BlockWhat it adds
TitleProduct name
PriceSale price, compare-at price, and Tax included text
Variant PickerColor swatches / size buttons / dropdowns
Quantity + ATCQuantity selector and Add to Cart button
Buy NowDynamic checkout (Shop Pay, PayPal, etc.)
DescriptionProduct description from Shopify Admin
Collapsible TabExpandable panel — great for ingredients, how to use, shipping
RatingStar rating (requires compatible reviews app)
Custom LiquidHTML or app embed code
Recommended block order that converts well: Rating → Title → Price → Variant Picker → Quantity + ATC → Buy Now → Description → Collapsible Tabs (Ingredients / How to Use / Shipping)

Product Star

A showcase section that highlights a single hero product with large imagery, key benefits, and a direct Add to Cart button. Ideal for featuring your best seller or a new launch. Found at: Theme Editor → Products → Add section → Product Star.

Settings

SettingWhat it does
ProductSelect the product to feature
Section HeadingOptional heading above the product, e.g. Our #1 Best Seller
LayoutImage Left / Image Right — positions the product image relative to info
Image StyleStandard, Rounded, or Full Bleed
Show PriceDisplays price and compare-at price
Show Variant PickerLets customers select a variant directly in this section
Show Add to CartInline Add to Cart button
Color SchemeBackground and text color for the section

Benefit Blocks

Add up to 4 benefit/feature blocks that appear alongside the product:

FieldWhat to fill in
Icon / ImageSmall icon representing the benefit
Benefit TextShort description, e.g. Clinically proven to reduce wrinkles by 40%
Pro tip: Use Product Star on the homepage to draw attention to a hero product, or on a product page to cross-sell a complementary item.

Product Recommendations

Automatically generated "You May Also Like" product suggestions displayed below the main product. Powered by Shopify's Recommendations API for personalised, AI-driven suggestions. Found at: Theme Editor → Products → Add section → Product Recommendations.

Settings

SettingWhat it does
Section HeadingTitle, e.g. You May Also Like or Complete Your Routine
Products to ShowMaximum number of recommended products (2–10)
Columns (Desktop)Products per row on desktop (2–5)
LayoutGrid or Carousel (horizontal scroll)
Fallback CollectionCollection to pull from if Shopify has no AI recommendations yet
Color SchemeBackground and text color for the section
Tip: Product recommendations improve over time as your store gets more traffic. Install the Search & Discovery app to manually boost or pin specific products in recommendations.

Collection Page

Shows all products in a specific collection. Customers can filter, sort, and switch between grid and list view. Found at: Theme Editor → Collections → Default Collection.

SettingWhat it does
Products Per PageHow many products load per page (or before Load More)
Enable Infinite ScrollAutomatically loads more products as the customer scrolls
Show Collection DescriptionDisplays the collection's description text above the product grid
Default Grid ColumnsProduct columns side by side on desktop
Show Grid/List ToggleLets customers switch between grid and list view
Show Sort ByShows a Sort By dropdown

Collection Filters

Powers the filter and sort sidebar on collection and search results pages. Uses Shopify's native Storefront Filtering API and requires the Search & Discovery app for custom filters.

Prerequisite: Install the free Shopify Search & Discovery app and configure your filters there. Eira reads them automatically.

Filter Types Supported

Filter TypeHow It Works
ListCheckbox list — multiple values selectable
SwatchColour/pattern swatches generated from variant option values
Price RangeDual-handle slider with min/max inputs
BooleanSingle toggle, e.g. In Stock Only

Key Settings

SettingDescription
Filter layoutSidebar (desktop left panel) or Drawer (slide-in panel)
Show filter countDisplays matching products next to each filter value
Pagination styleClassic pages, infinite scroll, or Load More button
Show active filtersPill-shaped active filter tags at top with ✕ to remove

All Collections

The collections listing page showing every collection in your store as a grid of cards. URL: /collections. Found at: Theme Editor → Collection list → All Collections.

Settings

SettingWhat it does
Page HeadingTitle at the top of the page, e.g. Our Collections or Shop by Category
Collections Per Row (Desktop)Cards per row on desktop (2–5)
Image RatioSquare, Portrait (3:4), or Landscape (4:3)
Card StyleOverlaid — title on image; Below — title under image
Show Product CountNumber of products displayed under each collection name
Sort OrderAlphabetical, Date Created, or Manual (as set in Shopify Admin)
Note: Each collection must have a Featured Image set in Shopify Admin → Collections → [Collection] → Collection image, otherwise a placeholder is shown.

Quick View Section

A dedicated section-level Quick View configuration for embedding quick-view-enabled product grids on any page. Unlike the global Quick View feature (Theme Settings), this section lets you add a Quick View product showcase to specific templates. Found at: Theme Editor → Add section → Quick View Section.

Settings

SettingWhat it does
Section HeadingTitle above the products, e.g. Quick Shop
CollectionCollection to pull products from
Products to ShowHow many products to display (2–12)
Columns (Desktop)Products per row on desktop (2–5)
Enable Quick ViewToggle Quick View modal on product card click
Show Quick AddShow Add to Cart button directly on cards
Color SchemeBackground and text color for the section
Difference from global Quick View: The global Quick View setting (Theme Settings → Product Cards) enables quick view across all product cards store-wide. This section creates a standalone product grid with Quick View specifically for a chosen page template.

Cart Page

The full-page cart showing the customer's current items, quantity controls, discount codes, and checkout. Found at: Theme Editor → Cart.

SettingWhat it does
Show Order NoteAdds an Order Note text field
Show Discount Code FieldShows a discount code input
Show Shipping EstimateLets customers estimate shipping costs
Checkout Button LabelCustom text for the checkout button

Blog Page (Article Listing)

Displays all articles in a selected blog as a grid of preview cards. Customers can filter articles by tag. Found at: Theme Editor → Blog Posts → Default Blog.

SettingWhat it does
Show Featured ImageDisplays article thumbnail on each card
Articles Per PageHow many cards appear per page
Enable Infinite ScrollAuto-loads more articles on scroll
Show Tag FilterTag list for filtering by topic
Filter PositionSidebar or Top Bar
Columns (Desktop)Article cards per row on desktop

Blog Article

The layout for individual blog post pages. Renders article content, author, publish date, featured image, tags, social sharing, and related posts. Found at: Theme Editor → Blog Posts → Default Article.

SettingWhat it does
Show Featured ImageFull-width header image at top of post
Show AuthorAuthor's name below the article title
Show DatePublish date
Show TagsClickable tag chips that filter the blog
Show Social ShareSocial sharing icons (Facebook, Twitter/X, Pinterest)
Show Related ArticlesArticle grid at the bottom of the post
Content WidthWidth of the article text column. 680–720px optimal for reading

Contact Page

A contact form with optional contact details (email, phone, address) and an embedded Google Map. Found at: Theme Editor → Pages → Contact.

SettingWhat it does
LayoutForm Only / Form + Info / Full Width Form
Show Name FieldAdds a Name input to the form
Show Phone FieldAdds an optional Phone Number input
Submit Button LabelText on the submit button
Show MapEmbeds a Google Map of your address
Note: When a customer submits the form, the message is sent to the email set in Shopify Admin → Settings → General → Sender email.

About Us Page

Full-featured layout for your brand's story page — hero banner, rich text + image, team/values grid, and brand stats. Found at: Theme Editor → Pages → About Us.

AreaKey Settings
Hero AreaHero Image, Hero Heading, Overlay Opacity, Hero Height
Brand StoryStory Heading, Story Text, Story Image, Image Position (Left / Right)
Stats / NumbersShow Stats toggle; each stat is a block with Number/Value + Label
Values / Team GridGrid Heading, Columns (2–4); each card has Image, Name/Title, Description

Content Page

The default template for standard Shopify pages — About, FAQ, Terms & Conditions, Privacy Policy, and any custom pages. Renders the page's rich text content with optional sidebar and additional sections. Found at: Theme Editor → Pages → Default Page.

Settings

SettingWhat it does
Content WidthNarrow (680px), Standard (800px), or Wide (1000px)
Show Page TitleDisplays the page title as an H1 heading
Show BreadcrumbShows breadcrumb navigation above the page content
Text AlignmentLeft, Center, or Right alignment for body text
Color SchemeBackground and text color

Adding Sections to Pages

Since Eira is an OS 2.0 theme, you can add any section below the page content — product grids, testimonials, newsletter signup, or custom sections. Go to Theme Editor → Pages → Default Page and click Add section below the main content block.

Tip: Create alternative page templates for different page types — e.g. a "FAQ" template with accordions, or a "Landing Page" template with no header/footer.

Password Page

The storefront password page shown when your store is password-protected (before launch or during maintenance). Features your brand's logo, a custom message, password input, and optional newsletter signup. Found at: Theme Editor → Pages → Password.

Settings

SettingWhat it does
Background ImageFull-screen background photo for the password page
LogoYour store logo (uses header logo if not set)
HeadingMain message, e.g. Coming Soon or We're Getting Ready
Subheading / Body TextSupporting text with details or a launch date
Show CountdownDisplays a countdown timer to your launch date
Launch DateDate and time for the countdown timer
Show Newsletter SignupEmail capture form for pre-launch subscribers
Newsletter HeadingText above the email input, e.g. Be the first to know
Overlay OpacityDarkens the background image for text readability (0–100%)
Note: The password is set in Shopify Admin → Online Store → Preferences. When you're ready to launch, uncheck "Restrict access to visitors with the password" to remove the password page.

Customer Account Dashboard

The My Account dashboard for logged-in customers. Shows recent orders, account details, and address management. URL: /account.

ElementDescription
Welcome messageGreets customer by first name
Recent OrdersLists last 5 orders with status, date, and total
Manage AddressesLink to the addresses management page
Account DetailsEmail address and name
Log outSigns the customer out

About (Brand Story Section)

A rich split-layout section — heading, body text, optional pull-quote, and an image. Ideal for a homepage brand introduction. Found at: Theme Editor → Add section → About.

SettingWhat it does
Section HeadingMain heading, e.g. Born from a love of clean beauty
Body TextYour brand story paragraph(s)
Quote / HighlightA short pull-quote in larger text
ImageBrand photo or founder portrait
Image PositionLeft or Right of the text

About Text

A clean, text-focused block for brand messaging — heading and body text only, centered or left-aligned. Found at: Theme Editor → Add section → About Text.

SettingWhat it does
HeadingSection title, e.g. Our Philosophy
TextBody copy. Supports basic formatting
Text AlignmentLeft, Center, or Right
Max WidthMaximum width of the text column

Brand Logos (Press / As Seen In)

A row of logos for an "As Seen In" press strip or certifications. Found at: Theme Editor → Add section → Brand Logos.

SettingWhat it does
Section HeadingLabel, e.g. As Seen In or Trusted By
Autoplay / ScrollAuto-scrolls the logo row in a loop
Logo HeightHow tall each logo renders
GreyscaleMakes all logos grey; coloured on hover

Highlight Text

A large, bold statement — brand tagline, mission statement, or seasonal message. A powerful visual pause between content-heavy sections. Found at: Theme Editor → Add section → Highlight Text.

SettingWhat it does
TextThe large statement, e.g. Radiance you can see. Science you can trust.
Text SizeSmall, Medium, Large, or Extra Large
Highlighted WordsComma-separated words that receive a special color highlight
Animated EntryText animates in word-by-word on scroll into view

Blog Posts

A preview grid of your latest blog articles. Drive traffic to your content and build authority. Found at: Theme Editor → Add section → Blog Posts.

SettingWhat it does
BlogChoose which blog to pull articles from
Posts to ShowNumber of article previews to display (2–6)
Show ExcerptShows the first few lines of the article
Columns (Desktop)Article cards per row on desktop
Image RatioLandscape (16:9), Square, or Portrait

Image Grid

A masonry or uniform grid of images — ingredients, lifestyle photography, lookbook, before/after results, or UGC. Found at: Theme Editor → Add section → Image Grid.

SettingWhat it does
Columns (Desktop)Images per row (2–5)
Grid StyleUniform — equal size; Masonry — varied heights
Image RatioSquare, Portrait, or Landscape
Layout WidthBoxed, Fluid, or Full Width

Instagram Feed

Displays your latest Instagram posts directly on your store. Requires connecting your Instagram Business account to Shopify. Found at: Theme Editor → Add section → Instagram.

SettingWhat it does
Section HeadingTitle, e.g. Follow Us @eira.beauty
Instagram HandleYour @username
Posts to ShowHow many photos to display (4–12)
Columns (Desktop)Photos per row
Setup required: Go to Shopify Admin → Sales Channels → Facebook & Instagram and connect your Instagram Business account.

Glow Set (Featured Set Section)

Showcases a curated skincare set or routine — group of products with combined pricing and a lifestyle image. Found at: Theme Editor → Add section → Glow Set.

SettingWhat it does
Section Heading / Subheadinge.g. The Glow Starter Kit / Everything you need for radiant skin
DescriptionAbout the set — what it includes and why it works together
Lifestyle ImageStyled photo of the set (flat-lay or model shot)
Product blocksAdd each product in the set; optional Custom Label per product (e.g. Step 1 — Cleanse)

Shoppable Videos

Embed short-form videos with tagged products — customers can shop directly from the video. Perfect for tutorials, routines, and product demos. Found at: Theme Editor → Add section → Shoppable Videos.

Section Settings

SettingWhat it does
Section HeadingTitle above the video grid, e.g. Shop the Look
SubheadingOptional supporting text below the heading
LayoutGrid or Carousel — controls how videos are displayed
Videos Per Row (Desktop)How many videos show side by side on desktop (2–4)
AutoplayVideos autoplay (muted) when scrolled into view
Color SchemeBackground and text color for the section

Video Blocks

Each video block contains:

FieldWhat to fill in
Video File / URLUpload an MP4 or paste a YouTube/Vimeo URL
Cover ImageThumbnail shown before the video plays
Tagged ProductProduct linked to this video — appears as an overlay card
CaptionShort description or CTA text below the video
Tip: Use vertical (9:16) videos for a TikTok/Reels feel, or square (1:1) for a balanced grid. Keep videos under 30 seconds for maximum engagement.

Skincare Guide

An interactive skincare routine builder — guide customers through a step-by-step regimen with product recommendations for each step. Found at: Theme Editor → Add section → Skincare Guide.

Section Settings

SettingWhat it does
Section HeadingTitle, e.g. Your Daily Skincare Routine
SubheadingSupporting text, e.g. Follow these steps for radiant skin
Layout StyleSteps (numbered vertical) or Tabs (horizontal switching)
Background ImageOptional lifestyle photo behind the guide
Color SchemeBackground and text color for the section

Step Blocks

Add up to 8 step blocks. Each step represents one part of the skincare routine:

FieldWhat to fill in
Step Labele.g. Step 1 — Cleanse
Step DescriptionBrief explanation of this step and why it matters
Recommended ProductProduct picker — the product recommended for this step
Step Image / IconVisual for this step — product photo or custom icon
Best Practice: Use 4–6 steps for an effective guide. Common routines: Cleanse → Tone → Serum → Moisturise → SPF (morning) or Cleanse → Exfoliate → Serum → Night Cream (evening).

Sub Banner

A secondary promotional banner — smaller than the Hero Banner, ideal for mid-page callouts, seasonal campaigns, or category highlights. Found at: Theme Editor → Add section → Sub Banner.

Settings

SettingWhat it does
Desktop ImageBanner image for desktop screens
Mobile ImageSeparate image optimised for mobile (portrait crop recommended)
HeadingOverlay text heading, e.g. New Arrivals
SubheadingSupporting text below the heading
Button LabelCTA button text, e.g. Shop Now
Button LinkURL the button navigates to
Text PositionLeft, Center, or Right — where the text overlay sits
Text ColorLight or Dark — choose based on image brightness
Overlay OpacityDarkens the image behind the text for readability (0–100%)
Banner HeightSmall, Medium, Large, or Full Screen
Tip: Place a Sub Banner between product grids to break up the page visually and promote a specific collection or seasonal campaign.

Custom Section

A blank, developer-friendly section accepting raw HTML, Liquid, and CSS through the Theme Editor. For merchants and developers needing custom code blocks, embeds, or third-party widgets. Found at: Theme Editor → Add section → Custom Section.

SettingDescription
ContentRich text / HTML code input area
Custom CSSScoped CSS applied only to this section instance
Section IDOptional custom HTML id attribute for targeting
Max widthConstrain content to full-width, wide, or container width
Section paddingTop and bottom spacing in pixels
Common Use Cases
  • Third-party embeds — Trustpilot, Klaviyo forms, TikTok feed, Google Maps iframe
  • Custom HTML banners that don't fit other sections
  • Liquid experiments without creating a new section file
  • App embeds that require a custom HTML block on specific pages

Customer Login

The Login page for Classic customer accounts. URL: /account/login. Not used with New customer accounts.

ElementDescription
Email fieldCustomer's registered email address
Password fieldAccount password with show/hide toggle
Forgot password linkSends a password reset email
Create account linkRedirects to the Register page

Customer Register

The Create Account page for Classic customer accounts. URL: /account/register. Not used with New customer accounts.

ElementDescription
First name / Last name fieldsCustomer's name
Email fieldEmail address (used as login)
Password fieldMust meet Shopify's minimum requirements

Order Detail

Full breakdown of a specific order when a customer clicks it from their account dashboard. URL: /account/orders/{order-id}.

ElementDescription
Order number & datee.g. Order #1001 — 15 June 2026
Order statusUnfulfilled, Fulfilled, Delivered, Cancelled
Line itemsProduct image, title, variant, quantity, price
Price breakdownSubtotal / Discounts / Shipping / Tax / Total
Tracking linkClickable tracking number if fulfilment tracking was added

Customer Addresses

The Addresses page where logged-in customers can view, add, edit, and delete saved shipping addresses. URL: /account/addresses.

404 Page

Shown when a customer visits a URL that doesn't exist. A well-designed 404 page helps customers recover and continue shopping. Found at: Theme Editor → Pages → 404.

SettingWhat it does
HeadingThe main message, e.g. Page Not Found
Button LabelCTA button text
Button LinkWhere the button takes the customer
Background ImageOptional full-width background photo
Show SearchShows a search bar on the 404 page

Breadcrumb

A navigational breadcrumb trail showing the customer's location in the site hierarchy. Appears automatically on collection, product, blog, article, and page templates. Outputs valid JSON-LD BreadcrumbList schema automatically for Google rich results.

TemplateBreadcrumb Path
ProductHome > Collection > Product Title
CollectionHome > Collection Title
ArticleHome > Blog Name > Article Title
BlogHome > Blog Name
PageHome > Page Title

Changelog

All notable changes to the Eira theme. Eira follows Semantic Versioning: MAJOR.MINOR.PATCH.

How to Update Your Theme

  1. 1
    Download the latest version from your purchase receipt or the Shopify Theme Store.
  2. 2
    In Shopify Admin, go to Online Store → Themes.
  3. 3
    Click Add theme → Upload zip file and upload the new version.
  4. 4
    Click Customize to review, then Publish when ready.
Always duplicate your current live theme before publishing an update — this preserves your current settings as a rollback point.

Version History

VersionDateSummary
1.0.02026Initial release of Eira theme