Shardline Theme Documentation
Version 1.0.0 · Online Store 2.0 theme for Shopify · by byte-force.de
1. Overview
Shardline is a dark, architectural theme for streetwear and fashion brands. Its signature element is the “Asymmetric mosaic”: angular tiles joined by metal seams, with soft light edges and a violet glow. Every three tiles form a segment; five segment shapes alternate down the page. The mosaic look continues in the mosaic headers of all other pages and in the full-screen mosaic menu.
- 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 (Dark, Anthracite, Light, Graphite, Violet) for content sections, plus control over seams, accents, fonts, buttons and layout.
- Full-screen mosaic menu, product tiles in the mosaic, product cards with quick add, filters, predictive search with exact matching, cart drawer, free-shipping bar, cookie notice, FAQ, contact form, blog and customer accounts.
- No third-party apps are required. App blocks are supported on the product page, in the featured product 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, “Shardline”, with the home page, collection, product, cart, blog, FAQ, contact and lookbook 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 tile and section shows in the theme editor. The demo content refers to the collection handles hoodies, baggy-pants, oversized-shirts, accessories, new-arrivals and sale; if yours have other handles, select your collections in the editor.
- One collection per product group, for example Hoodies, Baggy pants, Oversized shirts.
- A collection for new products (for example “New arrivals”), used by the product carousel and the search overlay.
- Collection numbers (the small “02”, “03” before titles) are set under Theme settings → Layout → Collection numbers in the format
handle:number, comma separated.
3.2 Menus
Go to Content → Menus. Create or edit:
| Menu | Used for |
|---|---|
| Main menu | Full-screen mosaic menu (opened with the menu icon in the header); nested items appear as sub-links below their parent |
| Footer shop | Link column “Shop” in the footer |
| Footer help | Link column “Help” in the footer (FAQ, Shipping, Returns, Contact) |
| Footer company | Link column “Company” in the footer |
| Footer legal | Link column “Legal” and the legal links in the bottom bar of the footer |
| Popular searches | Links 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-shop, footer-help, footer-company, footer-legal and popular-searches. Menus with other handles work too: select them in the section settings (Header, Footer link columns, Search overlay, Search page) or under Theme settings → Search.
3.3 Pages
Go to Online Store → Pages and create your pages (About, FAQ, Contact, Shipping and so on). Choose the matching Theme template in the page editor:
| Template | Use for |
|---|---|
| page (default) | Standard text page with mosaic header, optional side menu and closing link |
| faq | FAQ page with grouped questions and answers |
| contact | Contact page with form and info rows (uses the Shopify contact form) |
| mosaic | Lookbook or campaign page built from an asymmetric mosaic, followed by the page text |
3.4 Blog
Add posts under Content → Blog posts. The home page and article pages can show them with the “Blog teaser” section.
3.5 Optional product details (metafields)
Create the definitions under Settings → Custom data (namespace custom), then fill them in each product. Where a metafield is empty, the block shows the text you entered in the editor instead, or is hidden.
| Metafield | Effect |
|---|---|
product.metafields.custom.subtitle | Subtitle below the product title (Shopify’s descriptors.subtitle is used if empty) |
product.metafields.custom.material | Material row in the meta table of the product page; the key can be changed in the block setting “Material metafield key” |
Collapsible rows on the product page can also read any metafield: type the key without custom. into the block setting “Metafield key”.
3.6 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 icon 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.
- The text of the password page comes from the message you enter for the password page in your store settings; without a message, the text from the section is shown.
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 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.
5. Theme settings
Open them with the gear icon in the editor. Groups:
Colors
Five colour schemes – Dark (default), Anthracite, Light, Graphite and Violet – each with background, raised background, text, muted text, line and accent colour. Mosaic and accents: violet (light edges), lavender (hover, focus) and the two tones of the metal seams between tiles (light and dark). Status colours: success, warning, error and sale.
Typography
Heading and body font (any font of the Shopify font library). The default is Inter Light (300) for headings and Inter (400) for body text.
Layout
| Setting | Options |
|---|---|
| Maximum content width | 1200–1800 px, default 1360 |
| Gloss and light effects in the mosaic | On/off: glass sheen, violet glow, light arcs |
| Image zoom on hover | On/off |
| Reveal on scroll | On/off (off by default) |
| Collection numbers | handle:number, comma separated (section 3.1) |
| Text direction | Left to right or right to left |
Buttons and fields
Button height (44, 48 or 52 px).
Product cards
Image ratio (Portrait 4:5 or Square), second image on hover, quick add, vendor, the tag for the “New” badge and an optional tag for the “On request” badge (products with these tags get the badge).
Cart
Cart type (Drawer or Page), open drawer after adding, free-shipping bar and threshold (0–500, in store currency), order note, discount code field, additional checkout buttons.
Search
Only show products when the search term appears in: Title, Title or tags, or Title, tags or metadata (type, vendor, SEO title, SEO description). Without this, Shopify also returns “similar” products. Applies to the search page and quick search. “Popular searches” menu: its items appear as suggestions in quick search and on the search page.
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, TikTok, YouTube, Pinterest, Facebook and X. Enter your profile links. The icons appear in the bottom bar of the footer 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. Home page
The home page template contains the Asymmetric mosaic. Add further sections below it (product carousel, banner, testimonials and so on) like on any other page.
Asymmetric mosaic
Every three blocks form a segment. Five segment shapes alternate and then start again from the first (1-2-3-4-5-1 …). Block 1 is the hero. If the last segment has only one or two blocks, they fill the whole segment. Up to 21 blocks (7 segments). From 1200 px the desktop composition is shown, below it the mobile composition.
| Setting | Purpose |
|---|---|
| Show tile numbers on desktop | Numbers always show on mobile |
| Gloss and light effects | Glass sheen and light edges of the tiles |
| Reduce violet accents | Calmer look with less violet |
| Image zoom on hover | Slight zoom of tile images |
| Load first images with priority | The images of the first segment load first (recommended) |
| Mosaic starts under the header | Header icons sit on top of the tiles |
| Screen reader label | Name of the mosaic for screen readers |
Blocks:
| Block | Settings |
|---|---|
| Tile | Tile type (Photo, Light (product cut-out), Violet light gradient, Light arcs (sale), Light stairs, Dark, no image), number, heading, subtitle, text next to the arrow, link text for screen readers; target (collection, page or custom link, for example to a product; no target = plain image without a link; heading and texts can be left empty); desktop image and optional mobile image, image fit, image position desktop and mobile (empty = focal point of the image), readability gradient and strength, text colour |
| Product tile | Product, badge (automatic: sale, new, sold out; or none), cart button (for products with several variants it opens the product page), custom image and optional custom mobile image, image position, gradient strength |
| Navigation tile | Menu links as a tile (max. 1); without a menu it shows Shop, Categories and Search. Optional “Menu” button |
Which image size do I need?
Every tile has a different shape, so every tile needs a different image size. The theme editor shows you the right size and where your subject is safe:
- Open the theme editor and click a tile (or select its block in the list on the left).
- The ideal size appears on the tile, for example “Ideal image: 1430 × 870 px, Phone: 800 × 1550 px”. Width comes first, height second.
- A dashed frame appears as well. The tiles have slanted edges, and on large screens they cut off up to a third of the image. Only what is inside the dashed frame is always visible. Put everything important – the person, the product, the hood of a hoodie – inside this frame.
- Crop your image to the ideal size before you upload it, for example with Canva or Photoshop. Then check in the editor that the subject sits inside the dashed frame on computer and phone (switch the preview at the top of the editor).
“Phone” is the size for the optional mobile image. Without a mobile image, the normal image is used on phones too and cropped automatically. This also applies to product tiles (“Custom mobile image”).
Tip for photos: show the subject small, with plenty of empty background around it. A subject that fills the whole image will always be cut off by the slanted edges. If the mosaic starts under the header, the header also covers the top of the first tile, so keep the subject a little lower there.
The same works for the image tile of the mosaic header on other pages (select the section) and for the category tiles of the full-screen menu (select the block; the menu opens in the editor).
The size and frame depend on where the tile is in the mosaic. If you move, add or remove blocks, check them again. The hint is only visible in the editor, never in your shop.
7. Collection pages
The collection template has the mosaic header and the product grid with filters. Setting overview:
- Mosaic header: tiles (4, 3 or 2), title tile (Dark, no image or Violet light gradient), breadcrumb, number, heading and subtitle (empty = automatic). Tile 2: image or text (image: the collection image or the first product image is used if none is chosen), optional mobile image, light background for cut-outs, image fit and position. Tile 3: short description (empty = collection description). Tile 4: cross link to a collection or custom link with number, heading, subtitle and tile type.
- Product grid: products per page (8–48), filter position on desktop (drawer with “Filter” button, or sidebar on the left), fixed toolbar, and a lookbook insert (position in the grid, image, number, heading, text, button, link). On mobile the filters always open in a drawer.
The filters shown are the storefront filters of your collection. You define which filters exist with Shopify’s free Search & Discovery app; the theme only displays them.
The collection list page (“Collection list”) shows your collections as tiles with the collection image (or the first product image). Setting: show product counts.
8. Product page
Settings of “Product”: breadcrumb and sticky buy bar on mobile. Blocks (drag to reorder; most can be used once):
| Block | Settings |
|---|---|
| Title | Show vendor |
| Price | Show installments (Shop Pay) |
| Variant picker | Colour swatches (from swatch.color / swatch.image of the option values) and size buttons; size guide page (opens as a dialog next to the size picker) |
| Inventory status | In-stock text, “Only x left” threshold |
| Pickup availability | – |
| Buy buttons | Show quantity selector, show dynamic checkout buttons |
| Trust row | Three icons with text |
| Meta table | SKU, product type, material metafield key, collection |
| Description | Heading, open by default |
| Collapsible row | Index, heading, text, metafield key, page as content, open by default |
| Share | – |
| Text / Custom Liquid | Free text or your own Liquid |
| App block | Any app block |
Below the product: Product recommendations (intent “Related” or “Complementary”; complementary products are set in the Search & Discovery app) and Recently viewed. Both load when the visitor scrolls to them. The gallery supports images, videos, YouTube/Vimeo and 3D models; on desktop a click on an image opens it large. Selecting a variant shows its image. Gift card products show a recipient form.
9. Cart
- Cart drawer (editor: left panel, below the footer): recommendations with a collection of your choice, links when the cart is empty (menu). Free-shipping bar, order note, discount code field and checkout buttons follow Theme settings → Cart.
- Cart page (set Theme settings → Cart → Cart type to Page, or open
/cart): link when the cart is empty, payment icons and Promise blocks (icon and text). The “Cart recommendations” section shows products of a collection. - Line item and order discounts, unit prices and subscriptions (selling plans) are shown.
10. Pages, blog, search
- Page: show page title (not needed when the mosaic header shows it), intro, optional sidebar with side menu, closing text and link.
- FAQ: colour scheme, eyebrow, heading, text, only one open at a time, first question open. Add Group blocks (headings) and Question blocks (question and answer).
- Contact: text, subject options (comma separated), privacy checkbox text, info heading, response time and a menu; Info row blocks (label, value, link). The form is Shopify’s standard contact form; messages arrive at your store contact email.
- Blog: tag bar, excerpt, posts per page (6–24).
- Article: featured image, author, table of contents, comments (when enabled for the blog).
- Search page: results for products, articles and pages with filters and sorting; “Popular searches” menu. Which products appear is set under Theme settings → Search.
- Search overlay (predictive search): “Popular searches” menu and a “New arrivals” collection. Without a menu of its own, the overlay uses the menu from Theme settings → Search.
- 404 page: heading, text, search field and placeholder, button and link.
- Password page: logo text, image, eyebrow, heading, text and newsletter signup. It appears while your store is password protected.
- Gift card page: gift card code, QR code and Apple Wallet link.
11. Customer accounts
The header shows Shopify’s account component on desktop and mobile: customers sign in and open their orders and profile. Its links come from the customer account menu (default customer-account-main-menu, selectable in the Header section). To keep the first page load fast, the component is placed when the visitor first interacts with the page (moving the mouse, touching, scrolling or a key); until then the account icon links to the login page. Login, register, account overview, orders, addresses, account activation and password reset are also included as templates (classic customer accounts); the login page takes an image and a text.
12. Section reference
Sections that you can add to pages (Add section):
| Section | What it does |
|---|---|
| Asymmetric mosaic | Mosaic of angular tiles and product tiles in alternating segments (home page and pages) |
| Mosaic header | Page header with title, image, description and cross link as mosaic tiles |
| Product carousel | Products of a collection as a slider, heading optionally as a mosaic tile |
| Featured product | Gallery and full buy box for one product |
| Banner | Full-width image with text and up to two buttons; heights for mobile, tablet and desktop |
| Image with text | Image next to text, image left or right |
| Rich text | Blocks: eyebrow, heading (size), text, buttons; centred or left |
| Testimonials | Quotes with name and product |
| FAQ | Grouped questions and answers |
| Newsletter band | Email signup, optional violet background |
| Blog teaser | 2–4 posts of a blog |
| Contact form | Contact form with info rows (pages) |
| Product recommendations / Recently viewed | Product suggestions (product page; Recently viewed also on cart and search) |
| Cart recommendations | Products of a collection (cart page) |
| Custom Liquid | Your own Liquid, HTML or CSS |
| Apps | Place for app blocks and Custom Liquid |
Many content sections have a Color scheme setting: Dark (default), Anthracite, Light, Graphite and Violet accent.
13. Header, menus, footer
Announcement bar
In the header group. Messages as blocks (text, link; up to five). Settings: hide on the home page (the mosaic then starts at the very top), rotate messages on mobile every n seconds (3–10), close button.
Header
Settings: logo image and height (16–48 px), logo text (used when no logo is set), main menu, customer account menu, transparent over the home page mosaic, sticky header (shows on scroll up, hides on scroll down), search icon, country/language in the menu.
Full-screen menu
The menu icon opens a full-screen mosaic menu with the main menu on the left and up to four category tiles on the right. Add Menu tile (category) blocks in the Header section: collection, heading, number, tile type (Photo, Light (product cut-out), Violet light gradient), image, optional mobile image, image fit and position. Account link and country/language selector sit in the last tile.
Footer
Blocks: Link column (heading, number, menu) and Text column (heading, text). Settings: logo text, newsletter tile (heading, text), Follow on Shop (shows only when Shop Pay and Follow on Shop are active in your store), legal menu, text next to the copyright, payment icons, country/language selector.
14. 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.
15. Accessibility and motion
- Images below the visible area load when the visitor scrolls to them; images of the full-screen menu and the cart drawer load when they are opened. The first screen loads first.
- When the visitor’s device is set to “reduce motion”, reveal effects, the rotation of the announcement bar and smooth scrolling are off.
- All mosaic tiles are links with a visible focus state. The full-screen menu, the cart drawer and dialogs keep the keyboard focus inside and close with Escape. A “Skip to content” link is the first element of every page.
- To reduce effects further, turn off Theme settings → Layout → Gloss and light effects in the mosaic, image zoom on hover and reveal on scroll, or use “Reduce violet accents” in the Asymmetric mosaic.
16. FAQ and troubleshooting
| Problem | Solution |
|---|---|
| A mosaic tile shows a placeholder | Choose an image for the tile (Desktop image). Product tiles use the product’s main image automatically. |
| The image detail in a tile is wrong | Set a focal point on the image, or enter an image position (for example 50% 30%) for desktop and mobile. |
| Cannot add more tiles to the mosaic | The mosaic holds up to 21 blocks (7 segments). Add a second Asymmetric mosaic section for more. |
| Search shows products that do not contain the search term | Check Theme settings → Search → “Only show products when the search term appears in”. |
| No “New” badge on products | Check Theme settings → Product cards → “Tag for ‘New’” and tag your products accordingly. |
| Filters are missing on collection pages | Define filters with Shopify’s Search & Discovery app. |
| Collection numbers do not appear | Enter handle:number pairs under Theme settings → Layout → Collection numbers. |
| Cart drawer does not open | Check Theme settings → Cart → Cart type and “Open drawer after adding”. |
17. Support
Questions about the theme: use our support form (https://byte-force.de/themes/support). Enter the URL of your store, choose Shardline 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/shardline/doku/ · Theme page: byte-force.de/themes/shardline
18. Changelog
| Version | Notes |
|---|---|
| 1.0.0 | First release. |
© byte-force.de · Shardline is an independent theme and is not affiliated with Shopify Inc.