Heritage Grid Theme Documentation
Version 1.0.0 · Online Store 2.0 theme for Shopify · by byte-force.de
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.
- Built for Online Store 2.0: every page is made of sections that you add, remove and reorder in the theme editor.
- Five colour schemes – Light (ivory), Light 2 (linen), Dark (espresso), Dark 2 (umber) and Accent (bronze) – selectable per section.
- Shop the room: room images with hotspots on the home page, collection pages and product pages; each hotspot links to its product.
- Material lab: material tiles with a detail view (composition, care, surcharge, lead time), material selection and free material samples.
- Concierge: a consultation form in a side drawer, available from the announcement bar, product page, cart, collection page and footer; it takes the product, room or cart as context.
- Hero gallery, mega menu with image cards, product cards with quick add, filters, predictive search, cart drawer with free-shipping bar, recently viewed products, cookie notice, FAQ, contact page, blog and customer accounts.
- No third-party apps are required. App blocks are supported on the product page, in the “Featured product” section and in the “Apps” section.
- Languages: English (default) and German.
2. Installation
- Open your Shopify admin and go to Online Store → Themes.
- Add the theme from the Theme Store.
- 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:
| Type | Handles in the demo |
|---|---|
| By category | sofas, lounge-chairs, dining-tables, sideboards, coffee-tables, lighting, accessories |
| By room | living-room, dining-room |
| Other | new-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:
| Menu | Used for |
|---|---|
| Main menu | Navigation in the header and the mobile menu. A top-level item with two levels of sub-items becomes a mega menu (see section 14) |
| Footer | Link column “Shop” in the footer |
| Footer service | Link column “Service” in the footer |
| Footer legal | Link column “Legal” in the footer |
| Popular searches | Suggestions in the search overlay and on the search page |
| Customer account main menu | Menu 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:
| Template | Use for |
|---|---|
| page (default) | Text page with eyebrow and intro, optional side menu and closing link, followed by a concierge band |
| faq | FAQ page with grouped questions and answers |
| contact | Contact 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.
| Metafield | Type | Effect |
|---|---|---|
custom.designer | Single line text | Designer name above the product title and on product cards |
custom.subtitle | Single line text | Subtitle below the product title (Shopify’s descriptors.subtitle is used if empty) |
custom.material | Single line text | Material row in the meta table of the product page; the key can be changed in the block setting “Material metafield key” |
custom.masse | Multi-line or rich text | Collapsible row “Dimensions” in the demo product template |
custom.material_pflege | Multi-line or rich text | Collapsible 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
- The price note “incl. tax, plus shipping” is a theme option (Theme settings → Legal). Set it to match your tax settings.
- The free-shipping bar uses the threshold from Theme settings → Cart.
- The account button in the header appears when customer accounts are enabled in Settings → Customer accounts.
- Country and language selectors appear when your store sells in several markets or languages.
- Concierge requests and contact form messages are sent to the sender email of your store (Settings → Notifications).
- The “Follow on Shop” button in the footer appears when Shop Pay is enabled in your payment settings.
4. Using the theme editor
Open Online Store → Themes → Customize. In the editor:
- The top bar has three icons on the left: Sections (structure of the current page), Theme settings (gear icon) and Apps.
- The page selector at the top (it shows “Home page” at first) switches between templates: Home page, Products, Collections, Collection list, Gift card, Cart, Pages, Blogs, Blog posts, Search, Password and 404 page.
- The left panel shows three areas: the header group (announcement bar, header), the template (the sections of the selected page) and the footer group. Below these are Cart drawer, Concierge drawer and Search overlay; these settings apply to the whole store.
- Click a section to open its settings. Click the arrow next to a section to see its blocks. Use Add block or Add section to extend a page; drag to reorder.
- Every section has the setting Color scheme. Alternate light and dark schemes to separate sections.
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
| Setting | Options |
|---|---|
| Maximum content width | 1400–1800 px, default 1680 |
| Section spacing | Compact, Normal, Airy |
| Grid line system | Enable grid lines, opacity (2–20 %), bronze nodes |
| Motion | Reveal on scroll, image zoom on hover |
| Text direction | Left 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:
| Setting | Purpose |
|---|---|
| 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, button | Text next to the image |
| Show side list, list title | List of all objects in the room with image, title and price |
| Request button text | Button 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.
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.
- On the product page, enter the Option value of the tile exactly as the variant option is called (for example
Bouclé). “Choose this material” then selects the matching variant in the buy box. - Product options whose names are listed under Theme settings → Material lab are shown as material tiles in the buy box (block Variant picker → “Material options as tiles”). The tile shows the variant image; without it, the swatch you set for the option value in Shopify, or a matching material colour.
- Samples: “Order sample” collects up to the set maximum of materials in a small bar at the bottom of the screen. “Add to cart” adds the sample product once per material, with the material name as a line item property. Without a sample product, the button is hidden.
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
- Collection header: collection image as background (or a fallback image), eyebrow, description, breadcrumb, height normal or small.
- Product grid: products per page, filter position (drawer with “Filter” button, or sidebar on the left), sticky toolbar with sorting. A concierge card and a room card can be placed inside the grid at a chosen position (0 = off).
- Shop the room (collection) and Concierge band below the grid.
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:
| Block | Settings |
|---|---|
| Title | Show vendor; the designer metafield appears above the title |
| Price | Show installments (Shop Pay Installments, where available) |
| Variant picker | Colour options as swatches, material options as tiles, link “View material in detail” to the Material lab section |
| Inventory status | In-stock text, threshold for “Only x left” |
| Pickup availability | Local pickup information for the selected variant |
| Buy buttons | Quantity selector, concierge button and its text, dynamic checkout buttons, “Order samples” link |
| Trust row | Three icons with text (for example delivery, returns, warranty) |
| Meta table | SKU, product type, material metafield, collection |
| Description | Heading, open by default |
| Collapsible row | Index, heading, text, metafield key or page as content, open by default |
| Share, Text, Custom liquid | Share link; free text; your own Liquid code (for example an app snippet) |
| Apps | App 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
- Cart drawer (Theme settings → Cart → Cart type “Drawer”): line items with quantity, free-shipping bar, order note, recommendations from a collection, links when the cart is empty and a concierge note.
- Cart page: “Continue shopping” link, link for an empty cart, delivery note per line, concierge note and Promise blocks (icon, heading, text). The section Cart recommendations shows products from a collection.
- Discount code field, additional checkout buttons and order note are switched on or off under Theme settings → Cart.
11. Pages, blog, search
- Page: eyebrow, intro, optional sidebar with a side menu, closing text and link.
- FAQ: Group blocks (headings) and Question blocks; only one open at a time and open first question can be switched.
- Contact form: salutations, subject options, privacy checkbox text, response time, concierge button, FAQ teaser and Info row blocks (label, value, link).
- Blog: eyebrow, heading, subtitle, tag bar, excerpt, posts per page. Article: featured image, author, table of contents (built from the headings of the post), reading time.
- Search: results for products, pages and articles, with the “Popular searches” menu as suggestions. The Search overlay (opened with the search icon) shows predictive results while typing, popular searches and a “New arrivals” collection.
- 404 page and password page: image, texts and search field (404).
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
| Section | Use |
|---|---|
| Hero gallery | Full-screen image slider with product slides |
| Featured objects | Product grid or slideshow |
| Featured product | One product with gallery (images, video, 3D), variant picker and buy button on any page; supports app blocks |
| Product carousel | Products of a collection in a carousel |
| Room explorer / Shop the room (collection) / Seen in the room | Room images with hotspots (section 6.1) |
| Collection explorer | Two large collection panels |
| Material experience / Material lab (product) | Material tiles (section 6.2) |
| Designers and concierge | Up to four designer portraits with quote, plus a concierge area with up to four services |
| Concierge band | Band with text, services, phone number and concierge button |
| Banner | Large image with text block and up to two buttons |
| Image with text | Image left or right with text and button |
| Rich text | Eyebrow, heading, text and buttons, optionally centred |
| Testimonials | Customer quotes with name and product |
| Blog teaser | Latest posts of a blog |
| Newsletter band | Sign-up form with consent checkbox (customers are added with the tag newsletter) |
| FAQ, Contact form | See section 11 |
| Product recommendations, Recently viewed | Product page and other pages |
| Custom liquid | Your own Liquid, HTML or app code |
| Apps | App blocks of installed apps |
14. Header, menus, footer
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
- Images below the visible area load when the visitor scrolls to them; the first slide of the hero loads first.
- When the visitor’s device is set to “reduce motion”, reveal effects, hero autoplay, rotation of the announcement bar and smooth scrolling are off.
- Drawers (cart, concierge, menu, filters) and dialogs keep the keyboard focus inside and close with Escape. A “Skip to content” link is the first element of every page.
- Hotspots, swatches, material tiles and carousel arrows are buttons or links with labels for screen readers and a visible focus state.
- To reduce effects further, turn off Theme settings → Layout → Reveal on scroll, Image zoom on hover or Enable grid lines.
17. FAQ and troubleshooting
| Problem | Solution |
|---|---|
| A section shows a placeholder image | Choose an image in the section or block. Product slides and product cards use the product’s main image automatically. |
| The image detail is wrong | Set 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 place | Adjust Position X and Y of the hotspot block in the editor preview, on desktop and mobile. |
| The mega menu does not open | The “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 tiles | Add 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 variant | The “Option value” of the material tile must match the variant option value exactly. |
| The “Order sample” button is missing | Select a sample product under Theme settings → Material lab. |
| Concierge requests do not arrive | They are sent to your store email. Check Settings → Notifications and your spam folder. |
| No “New” badge on products | Check Theme settings → Product cards → “Tag for ‘New’ badge” and tag your products accordingly. |
| Filters are missing on collection pages | Define filters with Shopify’s Search & Discovery app. |
| Cart drawer does not open | Check Theme settings → Cart → Cart type and “Open drawer after adding”. |
| The grid lines are too strong or too weak | Change 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
| Version | Notes |
|---|---|
| 1.0.0 | First release. |
© byte-force.de · Heritage Grid is an independent theme and is not affiliated with Shopify Inc.