Lumenfold documentation
Set up your theme, configure its sections and find answers to common questions.
Browse by topic
Setup guides and section reference
Getting started
Installation, theme trials, templates and publishing.
- Install Lumenfold from the Shopify Theme Store
- Why your new installation differs from the demo
- A practical launch checklist
- Templates: create different layouts without changing every page
Brand & layout
Logos, typography, colours, spacing and motion.
- Logo, favicon and header sizing
- Fonts, colour schemes and spacing
- Motion, hover images and accessibility
Header & navigation
Menus, featured images, the announcement bar and footer.
- Create a dropdown or mega menu
- Add a featured image to a mega menu
- Sticky header, announcements and footer links
Home page & storytelling
Home page sections, image crops, video and shoppable content.
- Build an editorial home page
- Hero images, mobile crops and slideshows
- Shop the scene: place product hotspots
- Shop the set: let customers choose pieces together
Products & collections
Product templates, variants, cards, filters and collections.
- Product page blocks, variants and quantity
- Accordions and personalization fields
- Product cards: quick add, quick view and badges
- Collection banners, category links and buying guides
Cart, search & email
Cart settings, storefront search and newsletter signups.
- Cart drawer, shipping message and checkout controls
- Search, breadcrumbs and recently viewed products
- Newsletter sections and the newsletter popup
Troubleshooting
Missing content, menu issues, image quality and theme updates.
- A section is empty or showing placeholder products
- My menu image or dropdown is missing
- Changes show in the editor but not on the storefront
- Images are cropped, blurry or slow to load
Section reference
Section names, content blocks and available settings.
View all 49 articles →No articles found
Try another word or contact support.
Getting started
Installation, theme trials, templates and publishing.
Install Lumenfold from the Shopify Theme Store
Add Lumenfold directly from the Shopify Theme Store to try it with your own products and brand settings.
- Open the Lumenfold listing in the Shopify Theme Store and select Try theme. Sign in to the store where you want to use it.
- In Shopify admin, go to Online Store → Themes. Find Lumenfold under Draft themes and select Edit theme.
- Add your logo, select colours and fonts, and connect products and collections. Your changes are saved in the trial.
- Use Preview from the theme’s actions menu to check the storefront.
- When you are ready, choose Buy on the Lumenfold theme card. Purchase is required before publishing.
Why your new installation differs from the demo
Lumenfold includes the layout, typography, colour settings and sections. The demo’s product catalogue, furniture photography, collections, navigation menus and store pages belong to the demo store and are not included as store content.
- Create your own products and collections in Shopify.
- Replace image placeholders and onboarding text in each section.
- Select the products, collections, menus and pages requested by the section settings.
- Check that every visible button has a destination. Remove any section you do not need.
A practical launch checklist
- Add a logo and favicon; check both on a phone.
- Set colours and typography, then build your home page with your own photography.
- Create your navigation menus and connect them in Header and Footer.
- Check a product with variants, a sold-out product, a collection and the search results.
- Test quantity changes, quick add, the cart and checkout using Shopify’s appropriate test setup.
- Add your actual delivery, returns, privacy and contact information.
- Check mobile layouts, keyboard navigation, image crops and every important link.
- Confirm payment, shipping and domain settings in Shopify before publishing.
Templates: create different layouts without changing every page
A template is a shared layout. Changes to the default product template affect every product assigned to that template; changing one product’s data does not change the other products.
- In the editor’s page selector, choose the page type, then create a template based on an existing template.
- Add, remove or reorder sections and blocks for that layout.
- Save the template. In the relevant product, collection or page in Shopify admin, select it under Theme template.
- Preview an item actually assigned to that template.
Brand & layout
Logos, typography, colours, spacing and motion.
Logo, favicon and header sizing
- Open Theme settings → Brand to choose the logo, logo width and favicon.
- Open the Header section for a header-specific logo override, mobile logo width, logo visual scale and artwork position.
- If using a transparent home-page header, add a suitable transparent-header logo and text colour.
- Check the logo against both the hero and the header background after scrolling.
If a logo appears tiny despite a large width setting, check whether the image file contains excessive empty space around the artwork.
Fonts, colour schemes and spacing
- Use Theme settings → Typography for body and display fonts, text scale, heading scale and letter spacing.
- Use Colors to configure schemes. Choose a scheme separately in each section.
- Use Layout for maximum page width, page margin, section spacing and the editorial background grid.
- Use Components for button, input and media corner radii, product image ratio and card text alignment.
Motion, hover images and accessibility
In Theme settings → Motion, choose the motion level, whether sections reveal on scroll and whether a second product image appears on hover. The second-image effect needs at least two product images.
Keep controls understandable without hover. Add useful image descriptions in Shopify, use descriptive link labels, and test menus, variant choices, accordions and the cart with a keyboard. Check the mobile preview as well as the desktop view.
Home page & storytelling
Home page sections, image crops, video and shoppable content.
Build an editorial home page
A useful starting sequence is Aperture hero → Collection cards → Featured collection → Image with story → Shop the scene → FAQ → Newsletter. Adapt it to your catalogue instead of using every section.
- Open the home page in the editor and choose Add section.
- Set a clear heading, select real content and give the main button a destination.
- Drag sections to change their order. Use blocks to add individual cards, points or rows inside a section.
- Preview the whole page to check pacing, repeated messages and loading speed.
Hero images, mobile crops and slideshows
Aperture hero, Image banner and Slideshow support separate desktop and mobile imagery. Choose compositions that leave space for your text and keep the subject visible at both widths.
Aperture hero also includes maximum heading size, text width, image label and small note settings. Image banner offers overlay and mobile content positioning. Slideshow adds a Slide block for each slide, rotation timing and controls.
Shop the scene: place product hotspots
- Add Shop the scene and choose a lifestyle image.
- Add a Product point block for each featured item and select the product.
- Adjust the point’s horizontal and vertical positions until it sits on the item in the image.
- Test every hotspot on desktop and mobile, and check that the correct product opens.
Shop the set: let customers choose pieces together
- Add Shop the set. Add a Product block for each piece and select its product.
- Choose which blocks are selected by default, then set the image ratio, columns and button label.
- Preview the selection total and add-to-cart behaviour with in-stock products.
Video, before-and-after and rich media
Background video provides a muted visual background with fallback imagery. Video story presents a video with supporting copy. Shoppable video pairs a video with selectable products. Video gallery groups multiple clips.
Use Shopify-hosted video in the video picker and add a fallback image where available. Autoplay is controlled by the visitor’s browser and device; it is not guaranteed.
For Image comparison, select before and after images with matching framing, add clear labels and choose the starting divider position. Use authentic examples of your products.
Products & collections
Product templates, variants, cards, filters and collections.
Product page blocks, variants and quantity
Open a product template and select its Product section. Choose the desktop media width, media layout, image zoom and video looping. Available gallery layouts include Editorial grid, Stacked, Carousel and Carousel with thumbnails.
Arrange blocks such as Heading, Price, Inventory status, Variant picker, Quantity, Buy buttons, Description, Accordion and Pickup availability. Product titles, prices, stock and media come from the product in Shopify admin.
Use Variant picker → Color option style to choose Swatches or Buttons. Native Shopify swatch data supplies colours or images; colour names alone may appear as a neutral fallback. Quantity respects the selected variant’s minimum, maximum and increment rules.
Accordions and personalization fields
Add an Accordion block for material, sizing or delivery information. Enter content directly or select a page. Shared template content appears on all products using that template, so create a separate template when a group needs different information.
A Personalization field block adds customer-entered text to the product. Configure its label, placeholder, help text, maximum characters and whether it is required. Test the resulting cart item before launch.
Product cards: quick add, quick view and badges
Use Theme settings → Components for quick-add style, product quick view, ratings and sale/custom badge visibility. Individual product-list sections also have switches for vendor, swatches and quick add.
Sale prices use the product’s price and compare-at price. Ratings require compatible product review data; the theme does not create customer reviews. The small number in the image corner is a decorative product reference, not stock or a review score.
Products that require choices may lead customers to options instead of being added immediately. Check a simple product and a product with variants.
Collection banners, category links and buying guides
- Add collection images and descriptions in Shopify admin.
- In the collection template, open Collection. Configure image and description visibility, products per page, columns, sorting and filtering.
- Select a Category navigation menu to display links to related categories.
- Set the product-grid button, guide button, guide link and short collection note.
- For a guide on the same page, add a Multicolumn section with Section anchor set to a unique value such as
collection-guide. Set the guide link to#collection-guide.
Add an Image with story, FAQ or related collections below the grid to help shoppers make a decision.
Set up collection filters and product recommendations
Enable filtering in the Collection or Search section. Configure the available filters through Shopify’s Search & Discovery app; the theme displays the filters Shopify supplies. Products need the corresponding data for useful results.
The Product recommendations section supports related or complementary recommendations. Configure recommendations in Search & Discovery where needed. The section depends on Shopify returning suitable products.
If filters or recommendations are missing, first check the section switches, catalogue data and Shopify’s app configuration.
Cart, search & email
Cart settings, storefront search and newsletter signups.
Cart drawer, shipping message and checkout controls
Open Theme settings → Cart to choose the cart type, notes, vendor display, shipping estimator, terms requirement, terms page and reassurance text.
The Free shipping threshold controls the theme’s progress message. It does not create a free shipping rate. Configure actual rates and eligibility in Shopify’s shipping settings and check the message against your markets and currency.
Dynamic checkout is controlled in the Product section’s Buy buttons block. Payment methods and checkout availability are managed by Shopify and depend on your store configuration.
Search, breadcrumbs and recently viewed products
Enable search in Header and choose its desktop trigger style. The Search template controls filtering, sorting, results per page and product-card details.
Breadcrumbs and the back-to-top button are in Theme settings → Navigation and utilities. Add a Recently viewed section where it is useful; it will populate as the visitor browses products, subject to their browser storage settings.
When testing a new store, make sure products are active and available to the Online Store channel before investigating theme search.
Newsletter sections and the newsletter popup
Use the Newsletter section or the Footer’s Newsletter block to collect email signups. Set the heading, button label and privacy text to fit your store.
The Newsletter popup has its own Enable popup setting, display trigger, delay or scroll depth, and days before showing again. A popup that was dismissed may remain hidden until that interval has passed.
Troubleshooting
Missing content, menu issues, image quality and theme updates.
A section is empty or showing placeholder products
- Confirm the section has its required image, product or collection selected.
- Check that the selected products are active, available to Online Store and included in the collection.
- Check that the section is visible and that you are previewing the correct template.
- Save, then refresh the actual storefront preview.
Changes show in the editor but not on the storefront
Make sure you saved the correct theme and are using its preview link. Editing an unpublished theme will not change the published store. Also check the template assigned to the product, collection or page, and whether a market-specific customization is selected.
Images are cropped, blurry or slow to load
Use a consistent aspect ratio for product photography and images large enough for their display size. In sections with mobile-image settings, supply a mobile composition instead of forcing a wide crop onto a narrow screen.
Reduce unnecessarily large source files, avoid stacking multiple autoplay videos, and retest after disabling unrelated app embeds in a duplicate theme. Product image ratio is controlled in Components and in relevant section settings.
Add to cart or variant selection is not behaving as expected
- Check availability, inventory policy and quantity rules for the selected variant.
- Try the same product directly on its product page. Note whether the issue only occurs in quick add, quick view or Shop the set.
- Preview a duplicate theme with optional app embeds disabled to isolate a possible conflict. Do not uninstall an app just to test it.
- Send support the affected URL, exact steps, browser, theme version and a screenshot or recording.
Shop the set cannot directly add items that require a selling plan. Choose products appropriate for that buying flow.
Update Lumenfold through Shopify
- Open Online Store → Themes and find Lumenfold. Duplicate your current theme before making changes.
- When Shopify shows an update notification on the theme card, open it and read View release notes.
- Select Add to draft themes. Shopify adds the updated copy without publishing it.
- Review the updated copy. Check whether Shopify carried over any custom code, then test layouts, app integrations, menus, product options and the cart.
- Select Publish only after testing. Keep the previous theme as a backup.
If Shopify does not offer an update for your Theme Store installation, use a fresh copy from the Theme Store and review which settings need to be transferred.
Section reference
Section names, content blocks and available settings.
Aperture hero
Create a split editorial introduction. Add desktop and mobile images, set the copy width and heading size, and connect your primary action.
Settings available in 1.1.6:
Background video
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Collapsible media
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Row.
Settings available in 1.1.6:
Collection cards
Select a collection in each Collection block. Choose card proportions and columns, and enable mobile swiping if useful.
Content blocks: Collection.
Settings available in 1.1.6:
Collection index
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Comparison table
Configure the column headings and Feature row blocks to compare options accurately.
Content blocks: Feature row.
Settings available in 1.1.6:
Contact form
Add a contact heading, explanatory copy and a contact email. Customer messages submit through Shopify’s contact form.
Settings available in 1.1.6:
Custom Liquid
Add developer-supplied Liquid only when needed. Preview custom code in a duplicate theme first.
Settings available in 1.1.6:
Custom section
Build a composition from theme blocks, with a background image, overlay, content positioning and spacing.
Content blocks: Theme block.
Settings available in 1.1.6:
Editorial chapters
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Chapter.
Settings available in 1.1.6:
Editorial mosaic
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Story.
Settings available in 1.1.6:
FAQ
Add Question blocks with concise answers. Set whether the first item starts open and optionally link a longer guide.
Content blocks: Question.
Settings available in 1.1.6:
Featured blog
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Featured collection
Select a collection and the number of products. Configure columns, vendor, swatches, quick add and the view-all link.
Settings available in 1.1.6:
Featured product
Select one product to feature. Arrange the product-information blocks and configure media width and video looping.
Content blocks: App block, Vendor, Heading, Price, Text, Variant picker, Buy buttons, Description, Custom Liquid.
Settings available in 1.1.6:
Gallery
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Image.
Settings available in 1.1.6:
Image banner
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Image comparison
Use consistently framed before and after images with clear labels and a sensible initial divider position.
Settings available in 1.1.6:
Image with story
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Fact.
Settings available in 1.1.6:
Logo list
Add Logo blocks and choose the number of columns and logo treatment. Use logos you have permission to display.
Content blocks: Logo.
Settings available in 1.1.6:
Material library
Add a Material block for each finish or fabric. Use consistent close-up imagery and clear material descriptions.
Content blocks: Material.
Settings available in 1.1.6:
Multicolumn
Add Column blocks for benefits, buying guidance or service information. The Section anchor setting can connect a button to this section.
Content blocks: Column.
Settings available in 1.1.6:
Newsletter
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Newsletter popup
Enable the popup and choose its display trigger and repeat interval. Connect any promised incentive in your marketing setup.
Settings available in 1.1.6:
Product carousel
Select a collection and the number of products for a browsable product row.
Settings available in 1.1.6:
Product recommendations
Show related or complementary products supplied by Shopify recommendations. Check your Search & Discovery configuration.
Settings available in 1.1.6:
Promotion banner
Present an actual offer with its code, destination and fine print. Create the matching discount in Shopify.
Settings available in 1.1.6:
Promotion grid
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Promotion.
Settings available in 1.1.6:
Recently viewed
Show products the visitor has browsed. Set the count and whether the current product is excluded.
Settings available in 1.1.6:
Rich text
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Scrolling gallery
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Image.
Settings available in 1.1.6:
Scrolling text
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Message.
Settings available in 1.1.6:
Service strip
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Service.
Settings available in 1.1.6:
Shop the scene
Add a scene image, then select a product and position for each Product point block.
Content blocks: Product point.
Settings available in 1.1.6:
Shop the set
Add Product blocks and set initial selection. The section totals selected available variants and adds them together to the cart.
Content blocks: Product.
Settings available in 1.1.6:
Shoppable video
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Product.
Settings available in 1.1.6:
Slideshow
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Slide.
Settings available in 1.1.6:
Spacer
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Split collections
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Collection.
Settings available in 1.1.6:
Statistics
Add Statistic blocks with verified figures and context. Configure imagery and desktop columns.
Content blocks: Statistic.
Settings available in 1.1.6:
Store locations
Add Location blocks for real stores or showrooms and configure columns.
Content blocks: Location.
Settings available in 1.1.6:
Tabbed collections
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Collection tab.
Settings available in 1.1.6:
Tabbed content
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Tab.
Settings available in 1.1.6:
Testimonials
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Testimonial.
Settings available in 1.1.6:
Timeline
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Content blocks: Step.
Settings available in 1.1.6:
Vendor directory
Build a browsable brand directory using the catalogue’s vendor data; enable search for larger directories.
Settings available in 1.1.6:
Video gallery
Add Video blocks, choose the aspect ratio and columns, then check playback on mobile.
Content blocks: Video.
Settings available in 1.1.6:
Video story
Add this section in the theme editor, enter your content and choose the layout settings below. Preview it at desktop and mobile widths before publishing.
Settings available in 1.1.6:
Need help with Lumenfold?
Send your store URL and a description of the issue to our support team.