Heritage Grid Theme Documentation

Version 1.0.0 · Online Store 2.0 theme for Shopify · by byte-force.de

Menu names in this guide follow the Shopify admin. The admin and the theme editor appear in the language of your Shopify account; section and setting names in the editor follow that language too (English and German are included).

1. Overview

Heritage Grid is a calm, editorial theme for designer furniture, interiors and home brands with a curated range. Its signature element is the grid line system: fine 1-pixel lines with small bronze nodes run through the pages like an architect’s drawing. Large room images, a serif display font and warm colours (ivory, linen, espresso, bronze) give the store the feel of a showroom.

2. Installation

  1. Open your Shopify admin and go to Online Store → Themes.
  2. Add the theme from the Theme Store.
  3. Click Customize (button “Edit theme” in some admin versions) to open the theme editor. Click Publish when you are ready to go live.

The theme ships with one preset, “Heritage Grid”, with the home page, collection, product, cart, blog, article, FAQ, contact, search, collection list, password and 404 templates already filled with example content. Images of the demo store are not installed; until you choose your own images, the theme shows Shopify placeholders.

3. First-time setup

Do these steps once. They make the demo content of the theme show your own content.

3.1 Collections

Create your collections under Products → Collections and add products. You choose which collection each section shows in the theme editor. The demo content refers to these collection handles:

TypeHandles in the demo
By categorysofas, lounge-chairs, dining-tables, sideboards, coffee-tables, lighting, accessories
By roomliving-room, dining-room
Othernew-arrivals (used by the search overlay and carousels), sale

If your collections have other handles, select them in the section settings. Give every collection an image: it is used as the background of the collection header and in the collection list.

3.2 Menus

Go to Content → Menus. Create or edit:

MenuUsed for
Main menuNavigation in the header and the mobile menu. A top-level item with two levels of sub-items becomes a mega menu (see section 14)
FooterLink column “Shop” in the footer
Footer serviceLink column “Service” in the footer
Footer legalLink column “Legal” in the footer
Popular searchesSuggestions in the search overlay and on the search page
Customer account main menuMenu of the account button in the header (default menu of Shopify)

The demo content uses the menu handles main-menu, footer, footer-service, footer-legal and popular-searches. Menus with other handles work too: select them in the section settings (Header, Footer menu blocks, Search overlay, Search page).

3.3 Pages

Go to Online Store → Pages and create your pages (About us, FAQ, Contact, Designers, Materials and so on). Choose the matching Theme template in the page editor:

TemplateUse for
page (default)Text page with eyebrow and intro, optional side menu and closing link, followed by a concierge band
faqFAQ page with grouped questions and answers
contactContact page with form, info rows (phone, email, showroom, opening hours) and an image with text (uses the Shopify contact form)

Legal texts (imprint, privacy policy, terms, refund and shipping policy) are not part of the theme. Create them under Settings → Policies and add them to the “Footer legal” menu.

3.4 Blog

Add posts under Content → Blog posts (the demo uses a blog called “Journal”). The blog page can show a tag bar; tag your posts, for example Material, Care and Room. The home page and article pages show the latest posts with the “Blog teaser” section.

3.5 Optional product details (metafields)

Create the definitions under Settings → Custom data → Products (namespace custom), then fill them in each product. Where a metafield is empty, the element is hidden.

MetafieldTypeEffect
custom.designerSingle line textDesigner name above the product title and on product cards
custom.subtitleSingle line textSubtitle below the product title (Shopify’s descriptors.subtitle is used if empty)
custom.materialSingle line textMaterial row in the meta table of the product page; the key can be changed in the block setting “Material metafield key”
custom.masseMulti-line or rich textCollapsible row “Dimensions” in the demo product template
custom.material_pflegeMulti-line or rich textCollapsible row “Material and care” in the demo product template

Collapsible rows can read any metafield: type the key without custom. into the block setting “Metafield key”.

3.6 Material samples (optional)

To let customers order free material samples, create a product “Material samples” with a price of 0, give it the tag Sample and hide it from search engines if you like. Then select it under Theme settings → Material lab → Product “material sample”. Details in section 6.2.

3.7 Store settings that affect the theme

4. Using the theme editor

Open Online Store → Themes → Customize. In the editor:

5. Theme settings

Open them with the gear icon in the editor. Groups:

Colors

Five colour schemes – Light (ivory), Light 2 (linen), Dark (espresso), Dark 2 (umber) and Accent (bronze) – each with background, raised background, text, muted text, line and accent colour. Status colours: success, warning, error and sale.

Typography

Heading and body font (any font of the Shopify font library). The default is Cormorant for headings and Inter for body text. Also: letter-spacing of display headlines (0–12 %) and uppercase navigation.

Layout

SettingOptions
Maximum content width1400–1800 px, default 1680
Section spacingCompact, Normal, Airy
Grid line systemEnable grid lines, opacity (2–20 %), bronze nodes
MotionReveal on scroll, image zoom on hover
Text directionLeft to right or right to left

Buttons and fields

Button height (48, 52 or 56 px), arrow in buttons, input fields boxed or underline only.

Product cards

Image ratio (Landscape 4:3, Square or Portrait 4:5), second image on hover, quick add, vendor, the tag for the “New” badge and the tag for the “On request” badge (products with these tags get the badge; the demo uses New and On request).

Cart

Cart type (Drawer or Page), open drawer after adding, free-shipping bar and threshold (0–9,900 in store currency, default 5,000), order note, discount code field, additional checkout buttons, concierge note in the cart and the tag of sample products.

Concierge

Phone number, email, showroom address, opening hours, drawer title and intro, success text, privacy text and the showroom link (for example your contact page). See section 6.3.

Material lab

Product “material sample”, maximum number of samples per order (1–6, default 3) and the option names that are shown as material tiles (comma separated; default: Upholstery, Material, Stone, Front, Frame, Wood, Leather).

Legal

Tax and shipping note, link to the shipping information, cookie notice (on/off, title, text; uses Shopify’s Customer Privacy API) and link to the privacy policy.

Social media

Instagram, Pinterest, Facebook, YouTube, TikTok and X. Enter your profile links. The icons appear in the footer (brand block or “Social and language” block) and on the password page.

Favicon

Upload an image (32 × 32 px .png recommended).

Custom CSS

The “Custom CSS” group is added by Shopify to every theme. Use it for small style adjustments.

6. Shop the room, Material lab, Concierge

6.1 Shop the room

Three sections show a room image with hotspots: Room explorer (home page), Shop the room (collection) and Seen in the room (product page). They share the same settings:

SettingPurpose
Image (desktop)The room image. On desktop it is shown in full, without cropping
Image (mobile, 4:5)Optional portrait image for phones. Without it, the desktop image is cropped to the screen
Eyebrow, heading, text, buttonText next to the image
Show side list, list titleList of all objects in the room with image, title and price
Request button textButton below the list; opens the concierge with all objects of the room as context

Add one Hotspot block per object: choose the product (or enter a title and subtitle for objects that are not for sale) and set Position X and Position Y in percent of the image (0 % = left/top, 100 % = right/bottom). A hotspot with a product links straight to the product page; a hotspot without a product opens a small info box. On phones, hotspots near the edge are moved slightly inwards so they stay visible.

Tip: open the editor preview, place the hotspot roughly, then fine-tune X and Y while watching the preview. Check the result in the mobile preview as well. If you set a focal point on the image, the hotspots follow it.

6.2 Material lab

The sections Material experience (home page) and Material lab (product) show material tiles. Each Material tile block has an image, heading, subtitle, detail text, composition, care, surcharge, lead time, a collection “products with this material” and an availability switch. With Detail overlay on click a tile opens a detail view.

6.3 Concierge

The concierge is a consultation form in a side drawer. It opens from the announcement bar, the concierge card in the mobile menu, the hero gallery, the “Concierge band” and “Designers and concierge” sections, the buy box (block Buy buttons → “Show concierge button”), the room sections, the concierge card in the product grid, the cart drawer and cart page, the contact page and the footer. When it opens from a product, a room or the cart, the object names are filled in as context.

The form asks for name, email, phone and a message, and sends the request with Shopify’s contact form to your store email. No app and no external service is used. Texts and contact details are set under Theme settings → Concierge; the section Concierge drawer (below the footer group) controls whether your contact details are shown at the top of the drawer and the text of the submit button.

7. Home page

The demo home page contains, in this order: Hero gallery, Featured objects, Room explorer, Collection explorer, Material experience, Designers and concierge, Blog teaser. Add, remove and reorder sections as you like.

Hero gallery

Full-screen or compact (78 %) image slider. Settings: eyebrow, heading, text, two buttons, up to three claims (separate with /), autoplay and duration per slide, arrows, overlay strength and grid lines. Each Slide block has a desktop image, an optional mobile image (4:5), and an optional product: the slide then shows brand, object title and price of that product (or your own texts) and links to it.

Featured objects

Product grid from a collection or from single Product blocks. With “Show as slideshow” the products scroll horizontally with arrows and a counter (1 product on phones, 2 on tablets, 3–4 on desktops).

Collection explorer

Two large panels side by side (split 57 : 43 or 50 : 50, order can be swapped). Each Panel shows an image or a colour area, a collection, texts, a list of collection links from a menu and a button.

8. Collection pages

Filters are created with Shopify’s Search & Discovery app. Colour filters show swatches; set colours or images for option values in the product admin to control them.

9. Product page

The gallery shows all product media: images, videos, external videos (YouTube, Vimeo) and 3D models. On desktop, images open in a lightbox; on phones, the gallery swipes. The buy box is built from blocks you can reorder:

BlockSettings
TitleShow vendor; the designer metafield appears above the title
PriceShow installments (Shop Pay Installments, where available)
Variant pickerColour options as swatches, material options as tiles, link “View material in detail” to the Material lab section
Inventory statusIn-stock text, threshold for “Only x left”
Pickup availabilityLocal pickup information for the selected variant
Buy buttonsQuantity selector, concierge button and its text, dynamic checkout buttons, “Order samples” link
Trust rowThree icons with text (for example delivery, returns, warranty)
Meta tableSKU, product type, material metafield, collection
DescriptionHeading, open by default
Collapsible rowIndex, heading, text, metafield key or page as content, open by default
Share, Text, Custom liquidShare link; free text; your own Liquid code (for example an app snippet)
AppsApp blocks of installed apps

Section settings: breadcrumb, index number and a sticky buy bar on phones. Further sections of the demo template: Material lab (product), Seen in the room, Concierge band, Product recommendations (related and complementary) and Recently viewed.

10. Cart

11. Pages, blog, search

12. Customer accounts

The header shows Shopify’s account button. With new customer accounts, signed-in customers see their avatar and a menu with orders and profile (Header → “Customer account menu”, default customer-account-main-menu). With classic customer accounts, the button links to the login page, and the theme provides styled pages for login, register, account, order details, addresses, activation and password reset. Turn the button off with Header → Icons → Account.

13. Section reference

SectionUse
Hero galleryFull-screen image slider with product slides
Featured objectsProduct grid or slideshow
Featured productOne product with gallery (images, video, 3D), variant picker and buy button on any page; supports app blocks
Product carouselProducts of a collection in a carousel
Room explorer / Shop the room (collection) / Seen in the roomRoom images with hotspots (section 6.1)
Collection explorerTwo large collection panels
Material experience / Material lab (product)Material tiles (section 6.2)
Designers and conciergeUp to four designer portraits with quote, plus a concierge area with up to four services
Concierge bandBand with text, services, phone number and concierge button
BannerLarge image with text block and up to two buttons
Image with textImage left or right with text and button
Rich textEyebrow, heading, text and buttons, optionally centred
TestimonialsCustomer quotes with name and product
Blog teaserLatest posts of a blog
Newsletter bandSign-up form with consent checkbox (customers are added with the tag newsletter)
FAQ, Contact formSee section 11
Product recommendations, Recently viewedProduct page and other pages
Custom liquidYour own Liquid, HTML or app code
AppsApp blocks of installed apps

Announcement bar

Language switch on the left, text and phone number (tap to call), text and link on the right (without a link, the right link opens the concierge). Announcement blocks (text, link) rotate on phones; interval and close button can be set.

Header

Logo image or logo text, logo position on desktop (centre or left), main menu, secondary menu for the mobile menu, sticky header, transparent over the hero on the home page, search and account icons, customer account menu, and a concierge card in the mobile menu.

Mega menu block: enter the Menu item (title) exactly as the top-level item in your main menu is called (for example “Collections”). Its sub-items with their own sub-items become columns; sub-items without children are collected under the Column title. Two image cards (image or product, eyebrow, heading, link) appear next to the columns.

Footer

Settings: colour scheme, concierge band at the top (heading, text, button), legal menu in the bottom area, text next to the copyright, payment icons, country/language selector and the Follow on Shop button (shows only when Shop Pay is active in your store). Blocks: Brand and claim (brand name, claim, text, social icons), Menu (heading, menu), Text, Newsletter (with consent checkbox) and Social and language.

15. Languages

The storefront and editor texts are translated into English (default) and German. Add more store languages in your Shopify admin settings. Text you type into the editor (headings, buttons) can be translated with Shopify’s translation tools. Right-to-left reading is available under Theme settings → Layout → Text direction.

16. Accessibility and motion

17. FAQ and troubleshooting

ProblemSolution
A section shows a placeholder imageChoose an image in the section or block. Product slides and product cards use the product’s main image automatically.
The image detail is wrongSet a focal point on the image (in the image picker of the editor or under Content → Files). Use the optional mobile image for phones.
A hotspot points to the wrong placeAdjust Position X and Y of the hotspot block in the editor preview, on desktop and mobile.
The mega menu does not openThe “Menu item (title)” of the Mega menu block must match the title of the top-level menu item exactly.
Material options appear as buttons instead of tilesAdd the option name (for example “Upholstery”) under Theme settings → Material lab → Option names treated as material, and enable “Material options as tiles” in the Variant picker block.
“Choose this material” does not change the variantThe “Option value” of the material tile must match the variant option value exactly.
The “Order sample” button is missingSelect a sample product under Theme settings → Material lab.
Concierge requests do not arriveThey are sent to your store email. Check Settings → Notifications and your spam folder.
No “New” badge on productsCheck Theme settings → Product cards → “Tag for ‘New’ badge” and tag your products accordingly.
Filters are missing on collection pagesDefine filters with Shopify’s Search & Discovery app.
Cart drawer does not openCheck Theme settings → Cart → Cart type and “Open drawer after adding”.
The grid lines are too strong or too weakChange Theme settings → Layout → Grid line system → Opacity, or turn the lines off.

18. Support

Questions about the theme: use our support form (https://byte-force.de/themes/support). Enter the URL of your store, choose Heritage Grid and add screenshots if possible. You receive a confirmation by email; we reply within two business days. Alternatively write to support@themes.byte-force.de.

Support policy

Support covers questions about the theme’s settings and features, and bugs in the theme code (layout, links, logic). We fix confirmed bugs in a timely manner and critical bugs immediately. Not covered: apps from other developers, content of your store, and custom code changes.

Custom code

We do not support changes to the theme code. Before you edit code, duplicate the theme (Shopify admin → Online Store → actions menu (…) of the theme → Duplicate) and work on the copy, so you can always go back. For bigger custom work we recommend hiring a Shopify Partner.

Documentation: https://byte-force.de/themes/heritage-grid/doku/ · Theme page: byte-force.de/themes/heritage-grid

19. Changelog

VersionNotes
1.0.0First release.

© byte-force.de · Heritage Grid is an independent theme and is not affiliated with Shopify Inc.