Rotator Theme Documentation
Version 1.0.0 · Online Store 2.0 theme for Shopify · by byte-force.de
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.
- Built for Online Store 2.0: every page is made of sections that you add, remove and reorder in the theme editor.
- Four colour schemes (Light, Silver gray, Dark, Accent) for content sections, plus control over glow, fonts, buttons and layout.
- Mega menu, semi-transparent header, product cards with quick add and colour swatches, filters, predictive search, 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, “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.
- One collection per product group, for example Smartphones, Audio, Computing.
- A collection for new products (for example “New arrivals”), used by the featured collections and the search overlay.
- Products need an image to appear in the Hero gallery. Gift cards are skipped there.
3.2 Menus
Go to Content → Menus. Create or edit:
| Menu | Used for |
|---|---|
| Main menu | Main navigation in the header and the mobile menu; nested items become dropdowns or mega menu columns |
| Footer service | Secondary menu in the mobile menu and a footer link column (FAQ, Contact, Shipping) |
| Footer menu | Link column in the footer (for example collections) |
| Footer Rechtliches (legal) | Imprint, privacy policy, terms, withdrawal in the footer |
| Category chips | Sub-category chips below the hero on collection pages |
| 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-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:
| Template | Use for |
|---|---|
| page (default) | Standard text page with optional side menu and closing link |
| about | About page with service bar and editorial banner |
| faq | FAQ page with grouped questions and answers |
| contact | Contact 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.
| Metafield | Effect |
|---|---|
product.metafields.custom.subtitle | Subtitle below the product title (Shopify’s descriptors.subtitle is used if empty) |
product.metafields.custom.highlights | Highlights strip on the product page: one line per highlight in the format icon|value|text |
product.metafields.custom.technische_daten | Specifications table in the “Product details (tabs)” section: one Label: value per line |
collection.metafields.custom.welt | Colour scheme of the optional “Collection header” section (hell, silbergrau, dunkel, akzent) |
collection.metafields.custom.kopf_layout | Layout of the optional “Collection header” section (glass, compact, banner) |
reviews.rating, reviews.rating_count | Star 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
- 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.
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
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
| Setting | Options |
|---|---|
| Glow intensity | Off, Subtle, Strong. Applies to glass cards, ring platforms and light lines; many sections can override it. |
| Slow light pulse | On/off |
| Rotation impulse on image change | On/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.
| Setting | Purpose |
|---|---|
| Card content | Products (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. |
| Text | Subheading, heading, text, button label and link; on collection pages the category title and description can be shown instead. |
| Controls | Autoplay and interval (3–10 s), progress markers, scroll hint. Arrows, markers and keyboard control appear when at least two cards are shown. |
| Background | Included light room background, or your own desktop and mobile background photo; ceiling ring, minimum height (560–760 px), colour scheme and glow. |
| Show on | All 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:
- Hero gallery: as on the home page; “Show category title and description on category pages” replaces the heading with the collection title and description.
- Sub-category chips: menu for the chips, arrow buttons.
- Collection products: products per page (8–48), columns (2–5), filter position on desktop (drawer with “Filter” button, or sidebar on the left), fixed toolbar, and an optional promo tile (position, subheading, heading, button, image, 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 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):
| Block | Settings |
|---|---|
| Vendor | – |
| Title | Show product type, show vendor, show rating |
| Price | Show installments (Shop Pay) |
| Variant picker | Colour swatches (from swatch.color / swatch.image of the option values), buttons or dropdowns |
| 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, share buttons |
| Description | Heading, open by default |
| Collapsible row | Heading, text, metafield key, page as content, open by default |
| Text / Custom Liquid | Free text or your own Liquid |
| App block | Any 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
- Cart drawer (editor: left panel, below the footer): recommendations with a collection of your choice. Free-shipping bar, order note and checkout buttons follow Theme settings → Cart.
- Cart page (set Theme settings → Cart → Cart type to Page, or open
/cart): “Continue shopping” link, link when the cart is empty, payment icons, trust badges. The “Cart recommendations” section shows products of a collection. - Line item and order discounts, unit prices and subscriptions (selling plans) are shown; discount codes are entered at checkout.
10. Pages, blog, search
- Page: subheading, intro, optional sidebar with side menu, closing text and link.
- FAQ: subheading, heading, text, only one open at a time, first question open. Add Group blocks (headings) and Question blocks (question and answer).
- Contact: subheading, heading, text, salutations and subject options (comma separated), privacy checkbox text, response time, FAQ teaser and link; Info row blocks (icon, label, value, link). The form is Shopify’s standard contact form; messages arrive at your store contact email.
- Blog: subheading, heading, subtitle, tag bar, excerpt, posts per page.
- 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.
- Search overlay (predictive search): “Popular searches” menu and a “New arrivals” collection.
- 404 page: image, subheading, heading, text, search field, button and link.
- Password page: logo text, image, subheading, heading, text and newsletter signup. It appears while your store is password protected.
- Gift card page: card image, 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). 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 |
|---|---|
| Hero gallery | Rotating 3D gallery of glass cards on a light platform |
| Service bar | Up to six benefits with icon, heading, text and link (2 × 2 grid or one column on mobile) |
| Categories | Collection tiles, slider when there are more tiles than columns |
| Product grid | Rows and columns of products with colour selection and paginator |
| Featured collection | Products of a collection as grid or slider |
| Featured product | Gallery and full buy box for one product |
| Editorial banners | Banners with image, CSS motif or product image |
| Image with text | Image next to text, image left or right |
| Rich text | Blocks: subheading, heading (size), text, buttons; centred or left |
| FAQ | Grouped questions and answers |
| Newsletter band | Email signup with optional consent checkbox |
| Blog teaser | 2–4 posts of a blog |
| Contact form | Contact form with info rows |
| Product recommendations / Recently viewed | Product suggestions |
| Highlights strip / Product details (tabs) | Product information (product page) |
| Sub-category chips / Collection header | Collection navigation and header (collection page) |
| Custom Liquid | Your own Liquid, HTML or CSS |
| Apps | Place 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.
13. Header, menus, footer
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
- Animations (light pulse, light lines, reveal on scroll, autoplay) start only after the first visitor interaction (moving the mouse, touching, a key or the mouse wheel). The page loads without motion.
- When the visitor’s device is set to “reduce motion”, the Hero gallery switches cards without animation and reveal effects are off.
- The Hero gallery can be controlled with the keyboard (arrow keys, Home, End); autoplay pauses on hover and focus and can be stopped with the play button.
- To reduce effects further, set Theme settings → Light ring system → Glow intensity to “Off” and turn off the light pulse and reveal on scroll.
16. Troubleshooting
| Problem | Solution |
|---|---|
| Hero gallery shows only five cards | Five cards are visible at a time. When a collection has more products, the next ones load as customers rotate. |
| Hero gallery controls do not appear | They 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 gallery | The gallery follows the sort order of the collection. Change it under Products → Collections. |
| 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. |
| Paginator does not appear on the home page | It appears only when the collection has more products than one page shows. |
| Highlights or specifications show demo text | Fill the metafields, or edit the block texts (section 3.5). |
| 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 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
| Version | Notes |
|---|---|
| 1.0.0 | First release. |
© byte-force.de · Rotator is an independent theme and is not affiliated with Shopify Inc.