Rotator 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

Rotator is a light, premium theme for electronics and tech stores with a focused catalog. Its signature element is the “Hero gallery”: a rotating 3D gallery of glass cards on an elliptical light platform in a bright light room. Glass cards, ring platforms and soft light lines (the “light ring system”) carry the look through all pages.

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, “Rotator”, with the home page, collection, product, cart, blog, FAQ, contact and about templates already filled with example content.

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 the collection handles smartphones, audio, computing, tv-home-cinema, smart-home and new-arrivals; if yours have other handles, select your collections in the editor.

3.2 Menus

Go to Content → Menus. Create or edit:

MenuUsed for
Main menuMain navigation in the header and the mobile menu; nested items become dropdowns or mega menu columns
Footer serviceSecondary menu in the mobile menu and a footer link column (FAQ, Contact, Shipping)
Footer menuLink column in the footer (for example collections)
Footer Rechtliches (legal)Imprint, privacy policy, terms, withdrawal in the footer
Category chipsSub-category chips below the hero on collection pages
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-service, footer, footer-rechtliches, kategorien-chips and beliebte-suchen. Menus with other handles work too: select them in the section settings (Header, Footer menu blocks, Sub-category chips, Search overlay, Search page).

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 optional side menu and closing link
aboutAbout page with service bar and editorial banner
faqFAQ page with grouped questions and answers
contactContact page with form, info rows and FAQ (uses the Shopify contact form)

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 or collection. Where a metafield is empty, the section shows the text you entered in the editor instead.

MetafieldEffect
product.metafields.custom.subtitleSubtitle below the product title (Shopify’s descriptors.subtitle is used if empty)
product.metafields.custom.highlightsHighlights strip on the product page: one line per highlight in the format icon|value|text
product.metafields.custom.technische_datenSpecifications table in the “Product details (tabs)” section: one Label: value per line
collection.metafields.custom.weltColour scheme of the optional “Collection header” section (hell, silbergrau, dunkel, akzent)
collection.metafields.custom.kopf_layoutLayout of the optional “Collection header” section (glass, compact, banner)
reviews.rating, reviews.rating_countStar rating on the product page, filled by a product reviews app

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

Four colour schemes – Light, Silver gray, Dark and Accent – each with background, raised background, text, muted text, line and glow / light ring colour. Status colours: success, warning, error and sale.

Typography

Heading and body font (any font of the Shopify font library; the default is Inter) and heading letter spacing (−5 to 2 %).

Light ring system

SettingOptions
Glow intensityOff, Subtle, Strong. Applies to glass cards, ring platforms and light lines; many sections can override it.
Slow light pulseOn/off
Rotation impulse on image changeOn/off (product gallery)

Layout

Maximum content width (1200–1800 px, default 1320), section spacing (Compact, Normal, Airy), reveal on scroll, image zoom on hover, text direction (left to right or right to left).

Buttons and fields

Button height (42, 46 or 52 px) and arrow in buttons.

Product cards

Image ratio (Square, Portrait 4:5, Landscape 4:3), second image on hover, quick add, colour swatches, vendor, and the tag for the “New” badge (products with this tag 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, additional checkout buttons.

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, YouTube, X, LinkedIn, TikTok and Facebook. Enter your profile links. The icons appear in the footer brand block (when “Show social media icons” is enabled).

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, from top to bottom: Hero gallery, service bar, categories, product grid, featured collection and editorial banners. Change, remove or reorder them like any other section.

Hero gallery

Up to five glass cards on an elliptical light platform. The front card is the largest; the cards behind it get smaller, sit higher and turn toward the centre.

SettingPurpose
Card contentProducts (automatic, lazy loaded): products from the selected collection (all products if none is selected; on collection pages the current collection). Five cards are visible; more products load as customers rotate. Custom cards (blocks): add “Carousel card” blocks with product, image, category label, link and alt text.
TextSubheading, heading, text, button label and link; on collection pages the category title and description can be shown instead.
ControlsAutoplay and interval (3–10 s), progress markers, scroll hint. Arrows, markers and keyboard control appear when at least two cards are shown.
BackgroundIncluded light room background, or your own desktop and mobile background photo; ceiling ring, minimum height (560–760 px), colour scheme and glow.
Show onAll pages of this template, or only “All products” (shop).

Categories

Collection tiles with heading, subtitle and image (square, full tile width). Columns 3–6; with more tiles than columns the row becomes a slider with arrow buttons.

Product grid and featured collection

The Product grid shows rows × columns of products from a collection with clickable colour selection, variant overview and an optional paginator. The Featured collection shows products as a grid or slider; in grid layout a paginator appears when the collection has more products than one page shows.

Editorial banners

Two (or more) banners with subheading, heading, text and button. As background choose an image, a CSS motif (for example the ring) or a product image; the motif position can be set per banner.

7. Collection pages

The collection template has the Hero gallery (showing the current collection), sub-category chips, the product grid with filters and a featured collection. 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 optional Collection header section (glass hero with ring platform, compact or image banner) can be added instead of the Hero gallery.

The collection list page (“Collection list”) shows your collections as tiles. Settings: subheading, heading, text, layout (Asymmetric or Grid), product counts, link.

8. Product page

Settings of “Product”: breadcrumb, thumbnails (left or bottom), zoom button, main image on ring platform, colour swatch tints the ring glow, sticky buy bar on mobile, glow. Blocks (drag to reorder; most can be used once):

BlockSettings
Vendor–
TitleShow product type, show vendor, show rating
PriceShow installments (Shop Pay)
Variant pickerColour swatches (from swatch.color / swatch.image of the option values), buttons or dropdowns
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, share buttons
DescriptionHeading, open by default
Collapsible rowHeading, text, metafield key, page as content, open by default
Text / Custom LiquidFree text or your own Liquid
App blockAny app block

Below the product: Highlights strip (icons with value and text, or the custom.highlights metafield), Product details (tabs) (description, specifications or text per tab), Product recommendations (intent “Related” or “Complementary”; complementary products are set in the Search & Discovery app), an editorial banner and Recently viewed. The gallery supports images, videos, YouTube/Vimeo and 3D models; 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). 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
Hero galleryRotating 3D gallery of glass cards on a light platform
Service barUp to six benefits with icon, heading, text and link (2 × 2 grid or one column on mobile)
CategoriesCollection tiles, slider when there are more tiles than columns
Product gridRows and columns of products with colour selection and paginator
Featured collectionProducts of a collection as grid or slider
Featured productGallery and full buy box for one product
Editorial bannersBanners with image, CSS motif or product image
Image with textImage next to text, image left or right
Rich textBlocks: subheading, heading (size), text, buttons; centred or left
FAQGrouped questions and answers
Newsletter bandEmail signup with optional consent checkbox
Blog teaser2–4 posts of a blog
Contact formContact form with info rows
Product recommendations / Recently viewedProduct suggestions
Highlights strip / Product details (tabs)Product information (product page)
Sub-category chips / Collection headerCollection navigation and header (collection page)
Custom LiquidYour own Liquid, HTML or CSS
AppsPlace for app blocks

Most content sections have a Color scheme setting: Light (white), Silver gray, Dark and Accent (ice blue), and padding top and bottom (0–120 px). Sections with glass cards or ring platforms also have their own Glow intensity.

Announcement bar

In the header group. Messages as blocks (icon, text, link). Settings: colour scheme, rotate messages on mobile every n seconds (3–10), arrows, close button.

Header

Settings: logo image and width (60–240 px), logo text (used when no logo is set), main menu, secondary menu (mobile), sticky header, semi-transparent header (the header lies over the light room on every page), search icon, account icon and customer account menu, country/language selector, and a teaser tile with product in the mobile menu.

Mega menu

Enable it in the Header section, then add a Mega menu block and enter the name of a main menu item under “Menu item name”. Its submenus become columns, and two image cards (product or image, heading, text, link) can highlight products.

Footer

Blocks: Brand (logo or text, text, social media icons; max. 1), Menu (heading and menu, optional “Cookie settings” link) and Text. Settings: colour scheme, newsletter, payment icons, country/language selector, Follow on Shop (shows only when Shop Pay and Follow on Shop are active in your store), text next to the copyright.

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. Troubleshooting

ProblemSolution
Hero gallery shows only five cardsFive cards are visible at a time. When a collection has more products, the next ones load as customers rotate.
Hero gallery controls do not appearThey appear when at least two cards are available. Check that your products have images and are available on the Online Store.
Wrong order of products in the Hero galleryThe gallery follows the sort order of the collection. Change it under Products → Collections.
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.
Paginator does not appear on the home pageIt appears only when the collection has more products than one page shows.
Highlights or specifications show demo textFill the metafields, or edit the block texts (section 3.5).
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 Rotator 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.

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

18. Changelog

VersionNotes
1.0.0First release.

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