Shardline 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

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.

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, “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.

3.2 Menus

Go to Content → Menus. Create or edit:

MenuUsed for
Main menuFull-screen mosaic menu (opened with the menu icon in the header); nested items appear as sub-links below their parent
Footer shopLink column “Shop” in the footer
Footer helpLink column “Help” in the footer (FAQ, Shipping, Returns, Contact)
Footer companyLink column “Company” in the footer
Footer legalLink column “Legal” and the legal links in the bottom bar of the footer
Popular searchesLinks 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-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:

TemplateUse for
page (default)Standard text page with mosaic header, optional side menu and closing link
faqFAQ page with grouped questions and answers
contactContact page with form and info rows (uses the Shopify contact form)
mosaicLookbook 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.

MetafieldEffect
product.metafields.custom.subtitleSubtitle below the product title (Shopify’s descriptors.subtitle is used if empty)
product.metafields.custom.materialMaterial 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

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 – 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

SettingOptions
Maximum content width1200–1800 px, default 1360
Gloss and light effects in the mosaicOn/off: glass sheen, violet glow, light arcs
Image zoom on hoverOn/off
Reveal on scrollOn/off (off by default)
Collection numbershandle:number, comma separated (section 3.1)
Text directionLeft 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.

SettingPurpose
Show tile numbers on desktopNumbers always show on mobile
Gloss and light effectsGlass sheen and light edges of the tiles
Reduce violet accentsCalmer look with less violet
Image zoom on hoverSlight zoom of tile images
Load first images with priorityThe images of the first segment load first (recommended)
Mosaic starts under the headerHeader icons sit on top of the tiles
Screen reader labelName of the mosaic for screen readers

Blocks:

BlockSettings
TileTile 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 tileProduct, 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 tileMenu links as a tile (max. 1); without a menu it shows Shop, Categories and Search. Optional “Menu” button
Tip: set a focal point on your images (in the image picker of the editor or under Content → Files). With an empty “Image position”, the tile keeps the focal point visible on desktop and mobile.

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:

  1. Open the theme editor and click a tile (or select its block in the list on the left).
  2. The ideal size appears on the tile, for example “Ideal image: 1430 × 870 px, Phone: 800 × 1550 px”. Width comes first, height second.
  3. 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.
  4. 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.

Larger images do not look better, they only make the page slower. The sizes shown are already sharp on high-resolution screens. Save your images as JPG or WebP.

7. Collection pages

The collection template has the mosaic header and the product grid with filters. Setting overview:

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):

BlockSettings
TitleShow vendor
PriceShow installments (Shop Pay)
Variant pickerColour 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 statusIn-stock text, “Only x left” threshold
Pickup availability–
Buy buttonsShow quantity selector, show dynamic checkout buttons
Trust rowThree icons with text
Meta tableSKU, product type, material metafield key, collection
DescriptionHeading, open by default
Collapsible rowIndex, heading, text, metafield key, page as content, open by default
Share–
Text / Custom LiquidFree text or your own Liquid
App blockAny 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

10. Pages, blog, search

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):

SectionWhat it does
Asymmetric mosaicMosaic of angular tiles and product tiles in alternating segments (home page and pages)
Mosaic headerPage header with title, image, description and cross link as mosaic tiles
Product carouselProducts of a collection as a slider, heading optionally as a mosaic tile
Featured productGallery and full buy box for one product
BannerFull-width image with text and up to two buttons; heights for mobile, tablet and desktop
Image with textImage next to text, image left or right
Rich textBlocks: eyebrow, heading (size), text, buttons; centred or left
TestimonialsQuotes with name and product
FAQGrouped questions and answers
Newsletter bandEmail signup, optional violet background
Blog teaser2–4 posts of a blog
Contact formContact form with info rows (pages)
Product recommendations / Recently viewedProduct suggestions (product page; Recently viewed also on cart and search)
Cart recommendationsProducts of a collection (cart page)
Custom LiquidYour own Liquid, HTML or CSS
AppsPlace for app blocks and Custom Liquid

Many content sections have a Color scheme setting: Dark (default), Anthracite, Light, Graphite and Violet accent.

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

16. FAQ and troubleshooting

ProblemSolution
A mosaic tile shows a placeholderChoose an image for the tile (Desktop image). Product tiles use the product’s main image automatically.
The image detail in a tile is wrongSet 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 mosaicThe 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 termCheck Theme settings → Search → “Only show products when the search term appears in”.
No “New” badge on productsCheck Theme settings → Product cards → “Tag for ‘New’” and tag your products accordingly.
Filters are missing on collection pagesDefine filters with Shopify’s Search & Discovery app.
Collection numbers do not appearEnter handle:number pairs under Theme settings → Layout → Collection numbers.
Cart drawer does not openCheck 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

VersionNotes
1.0.0First release.

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