Operator Theme Documentation
Operator is a fast, app-free Shopify Online Store 2.0 theme with a dark, tactical aesthetic and a signature red accent. It is built for independent merchants who want a serious storefront without paying for a stack of plugins.
What Operator is
Operator is a complete storefront system. Everything you normally bolt on with paid apps — mega menus, before/after sliders, countdowns, comparison tables, FAQ with rich results, lookbooks, wishlists, a compare page, predictive search, a cart drawer with upsells — ships inside the theme and runs natively. No script tags, no monthly app fees, no third-party scripts slowing your store down.
Built for speed
Self-hosted fonts, vanilla JavaScript web components, lazy-loaded media, and built-in JSON-LD. No external libraries to download on every page.
Designed to convert
A confident, high-contrast look with sticky add-to-cart, trust rows, volume discounts, and honest countdowns that build urgency without gimmicks.
No app dependency
Reviews, FAQ schema, before/after sliders, mega menus and more are native. You only add apps if you genuinely want to.
Made for the little guy
Twelve ready-made demo presets (Outpost, Drop, Roastery, Atelier, Beauty, Pets, Plants, Sports, Sunglasses, Watches and more) get a solo merchant live in an afternoon.
Who it’s for
Independent and small merchants in apparel, gear, coffee, supplements, beauty, pets, and lifestyle niches — anyone who wants a premium, opinionated storefront and the freedom to run it without a developer or a pile of subscriptions.
Operator works fully standalone. It also recognizes the optional Shadow Suite app via metafields — when that app is installed, extra reviews and loyalty features light up automatically. Nothing is required.
Getting started
Install the theme, learn the editor, load a demo, and make your first edits. Most stores are presentable within an hour.
1. Add the theme to your store
- In your Shopify admin go to Online Store → Themes.
- Under Theme library, choose Add theme and add Operator (from the Shopify Theme Store or by uploading the theme zip you received).
- Operator now sits in your library as an unpublished draft. You can customize and preview it safely before going live.
Customize and preview on the draft copy first. Only use Publish (Actions → Publish) when you are happy. Publishing replaces your live theme; it does not delete the old one.
2. Open the theme editor
From Themes, click Customize on Operator. The editor has three parts:
- Left panel — the list of sections on the current page. Click any section to edit its settings, or drag to reorder. Use Add section / Add block to build the page.
- Center — a live preview that updates as you change settings.
- Top bar — the page selector (Home page, Products, Collections, Cart, etc.), the device toggle (desktop / mobile), and Theme settings (the gear icon) for global options.
3. Load a demo preset (recommended)
Operator ships with 12 home-page presets so you don’t start from a blank page. In the theme editor, open the page dropdown at the top, pick a homepage template, then style it. The presets are:
Each preset is a curated arrangement of real Operator sections. Swap your own images, text and products in and you have a finished homepage.
Presets use placeholder text and sample products. Replace them with your own copy and link real collections/products before publishing. There is also a Demo Importer page template if you want guided setup.
4. Recommended first steps
- Open Theme settings → Brand and add your logo, favicon, brand name and tagline.
- Open Colors — pick a palette preset or set your own brand red and neutrals.
- Open Typography — choose your display and body fonts.
- Build your menus in Shopify admin (Navigation), then wire them into the Header.
- Set up your Cart style and free-shipping bar under Theme settings → Cart.
- Preview on mobile using the device toggle, then publish.
Global theme settings
Theme settings (the gear icon in the editor) control the look of your entire store at once. Set these once and every page inherits them. Operator groups roughly 120 settings into the tabs below.
Brand
- Logo / Logo (dark)
- Upload a light logo (for dark backgrounds) and an optional dark variant. Control its logo_width.
- Favicon
- The small icon shown in browser tabs.
- Brand name & Tagline
- Used as text fallbacks and in structured data when no logo image is set.
Colors
Start with a Palette preset (color_palette) for a one-click skin — Custom, Mono, Arctic and more — or set the 16 individual tokens. They are grouped as:
| Group | Tokens | Purpose |
|---|---|---|
| Neutrals | black · void · surface · s2 · border · b2 | Page and panel backgrounds, borders, dividers. |
| Brand | red · red_2 | The signature accent (default #cc0000) and its brighter highlight. |
| Text | white · w2 · muted · m2 · m3 | Primary text down to faint captions. |
| Semantic | green · yellow · blue | Success / in-stock, warning / sale, and informational accents. |
Typography
- Display font & scale
- The font for big headings (default ships a tall, tactical display face). type_display_scale tunes overall heading size.
- Body font & scale
- The font for paragraphs and UI. Operator self-hosts Barlow / Barlow Condensed / JetBrains Mono for speed.
- Uppercase eyebrows / buttons
- Toggle the all-caps tactical treatment on small labels and button text.
Layout
- Container max width
- layout_container_max sets your boxed content width. Operator is a boxed layout (range 1200–1680 px); the shipped default is 1320 px.
- Section spacing
- The vertical rhythm between sections.
- Corner radius
- layout_radius (0–16 px). The tactical look defaults to 0 (sharp corners).
- Border width
- Thickness of the hairline borders used throughout the UI.
- Default pagination
- Numbered buttons, a Show more button, or Infinite scroll — the store-wide default for collections.
Buttons
Set Primary (background / text / hover), Secondary (background / text / border) and Shape options — including an optional btn_arrow_icon and its position. Leave the colors blank to inherit your brand red.
Product cards
Controls how products look in every grid, carousel and list:
- Image ratio (natural / square / portrait), corner radius, and hover-to-show-second-image.
- Toggle color swatches, quick add, quick view, wishlist, vendor, rating stars and compare-at price.
- Choose badge style and quick-add button style.
Badges
Fine-grained control over the corner badges on cards: an automatic Sale badge (-%), a custom text badge, and an image badge — each with optional colors, size and corner. Placement sets the corner and X/Y offset.
Product page
- Gallery layout
- Thumbnails left / right / bottom, and more — the store-wide default (each product template can override).
- Zoom
- Enable click/hover zoom on product media.
- Sticky add to cart
- Keeps the buy button visible as the shopper scrolls.
- Variant-aware media
- The gallery jumps to the matching image when a variant is selected.
- Inventory meter + threshold
- Show a low-stock meter and set the count at which “low stock” appears.
- Pickup & Recently viewed
- Toggle in-store pickup availability and a recently-viewed row.
Cart
Choose the Cart style (slide-out Drawer, full Page, or a quick Notification popup), the free-shipping bar and its threshold, the Upsell engine mode (off / auto / manual), order notes, and gift wrap. See Cart.
Header
Global header behavior: sticky header, transparent over hero, and which icons appear (search, account, wishlist), plus the master mega-menu toggle. See Header & navigation.
Search
Enable predictive search and choose what it surfaces: products, collections, articles, pages.
Social
Add your Instagram, TikTok, Facebook, X, YouTube, Pinterest URLs (used in the footer and social sections), control share buttons on product pages, and set a default Open Graph image and Twitter handle for link previews.
SEO & structured data
Operator emits clean JSON-LD with no app required. Toggle each schema independently:
- Organization, Product, Article, BreadcrumbList, FAQPage, WebSite.
- Let Shadow Suite handle structured data — if you run the Suite app and want it to own schema, flip this on to avoid duplicates.
Animations
Toggle scroll-in reveal animations and hover effects globally. Both respect the visitor’s reduced-motion preference.
License & Advanced
- License
- Stores your purchase code and the Enable Suite hooks toggle for the optional Shadow Suite integration.
- Advanced
- Optional custom CSS, custom <head> and custom <body> code, preconnect domains, a demo palette switcher, and bring-your-own AI key fields (an optional Gemini-powered Brand Coach panel in the editor).
Use the Advanced custom-code fields for tags and styling only. Do not paste API keys or tokens into theme files.
Header & navigation
Operator ships several header styles plus a built-in three-level mega menu, announcement bar, and top bar — no navigation app needed.
Header layouts
Pick the header section that fits your brand from the Header group in the editor:
| Section | Best for |
|---|---|
| Header | The standard logo-center / nav layout with search, account, cart and wishlist icons. |
| Header — Compact | A slimmer bar that maximizes selling space above the fold. |
| Header — Tiles | A bolder header with tile-style featured links. |
| Header — Vertical | A side/vertical navigation style for editorial and lookbook stores. |
Global header behavior (sticky, transparent-over-hero, which icons show) lives in Theme settings → Header.
The mega menu (3 levels)
The mega menu turns top-level links like Shop and Features into rich, grouped panels. Build it entirely from Shopify’s native menu editor:
- In admin go to Online Store → Navigation and open your main menu.
- Level 1 = the top bar item (e.g. Shop).
- Level 2 = the column headings inside the panel (e.g. Men, Women, New In). Nest these under the Level 1 item.
- Level 3 = the links inside each column (e.g. Jackets, Tees). Nest these under the Level 2 item.
- Enable the master toggle in Theme settings → Header → Enable mega menu, then in the Header section choose which top-level items open as mega panels and optionally add a featured image/promo per panel.
Operator can show a small icon next to menu links. Add the icon by referencing it in the link (per the icon names in the built-in Utility — Icon library) so categories like Sale or New stand out.
Announcement bar
The Header — Announcement bar section sits above the header for rotating promos, shipping notices, or a discount code. Add multiple messages as blocks; set colors, links, and (optionally) auto-rotation.
Top bar
The Header — Top bar adds a thin utility strip for things like contact details, store hours, or a country/language picker, sitting above the announcement bar.
Country / language & search
- Country & language selectors appear when you have multiple markets/locales enabled in Shopify Markets; place them in the header or footer.
- Search opens a predictive search modal (Utility — Search modal). Configure what it returns under Theme settings → Search.
Footer
The footer is built from the Footer group: the main Footer section (link columns, newsletter, payment icons, social), an optional oversized Footer — Logo banner, and a Footer — Sticky nav bar for mobile.
Homepage & sections
Operator includes 116 merchant-facing sections. Add any of them on the homepage, on pages, or wherever sections are allowed. Below is the full categorized reference, with the important sections expanded.
In the editor, click Add section, search by name (Operator groups them with a category prefix like Banner —, Products —, Content —), then fill in its settings and blocks.
FAQPage JSON-LD for rich results. Add each question/answer as a block.Collection banner (single H1)
Every collection page is led by the Collection banner (main-collection-banner). It provides the page’s one and only <h1> (the collection title), a built-in eyebrow label, an automatic breadcrumb, and the collection description. Width, top/bottom padding, heading and body sizes, and per-device (mobile) overrides are all adjustable in its settings — so you can tune height, spacing, alignment and typography per store without touching code.
Because the banner owns the page H1, your hero and content sections should use H2/H3. This keeps every page to a single H1 for clean SEO. See best practices.
Product pages
The product page is fully modular. The media gallery sits beside a stack of blocks you add, remove and reorder in the editor — plus 22 ready-made product templates you can apply per product.
Gallery layouts
Set the default under Theme settings → Product page → Gallery layout (thumbnails left, right, or bottom, and more), with zoom, sticky add-to-cart and variant-aware media as global toggles. Individual product templates can override the layout entirely.
Modular product blocks
On the Product information section, click Add block to assemble the buy box. Available blocks:
| Block | What it does |
|---|---|
| Title · Vendor · SKU | Product name, brand and SKU. |
| Rating | Star rating (data-driven when Shadow Suite is present). |
| Price | Price with optional compare-at and savings. |
| Inventory meter | Low-stock bar driven by your threshold setting. |
| Variant picker | Variant selectors, including color swatches. |
| Quantity | Quantity stepper. |
| Volume discounts table | Tiered “buy more, save more” pricing. |
| Buy buttons | Add to cart + dynamic checkout buttons. |
| Bundle / build-a-box | Let shoppers assemble a custom bundle. |
| Subscription | Subscription/selling-plan selector. |
| Pickup availability | Local in-store pickup status. |
| Shipping estimate | Estimated delivery messaging. |
| Description | The product description body. |
| Accordion row | Collapsible details (materials, shipping, returns). |
| Trust icon row · Trust badge | Reassurance icons and trust badges. |
| Size guide trigger | Opens the matching Size chart. |
| Share | Social share buttons (toggle globally under Social). |
| Countdown timer · Live counters | Urgency: a per-product countdown and live view/sold counters. |
| Custom Liquid · Spacer | Custom markup and spacing control. |
Color swatches (name-driven)
Operator renders color swatches automatically. If a variant uses a Shopify swatch value it uses that color; otherwise it maps the option name (e.g. “Forest Green”, “Navy”) to a hex via the built-in color palette. That means swatches just work — no metafields or app required — as long as your option names are normal color words.
For unusual or brand-specific colors, set a Shopify swatch (image or color) on the variant in admin so the exact shade shows.
Product template variants (?view=)
Operator ships 22 product templates. Assign one to any product in admin (Products → [product] → Theme template), or preview any of them with a ?view= URL parameter, e.g. /products/your-product?view=minimal. Available templates:
Pick the template that matches the product: immersive for hero products, minimal for simple items, grouped for product families, preorder / sale for those states.
Collections
Collection pages combine the single-H1 banner with a flexible product grid. Eight ready-made collection templates cover the common layouts.
Layout templates
Assign a collection template in admin (Collections → [collection] → Theme template) or preview with ?view=:
| Template | Layout |
|---|---|
| default | Standard grid with sidebar filters. |
| vertical-filter | Filters in a left sidebar. |
| horizontal-filter | Filters in a horizontal bar above the grid. |
| no-filters | Clean grid with sorting only. |
| pagination-infinite | Infinite scroll — products load as you scroll. |
| pagination-show-more | A “Show more” button instead of numbered pages. |
| editorial | A magazine-style, content-forward collection. |
| lookbook | Shoppable lookbook presentation. |
The store-wide default pagination (numbered / show-more / infinite) is also set globally under Theme settings → Layout → Default pagination.
Setting up filters
Operator already knows how to display every kind of filter — color swatches, price sliders, brands, sizes, weights, materials, anything. You just tell Shopify which filters to turn on. This is a one-time, no-code setup that takes about two minutes.
Shopify stores filter settings on your store, not in the theme — this is true for every Shopify theme, including Shopify’s own. A theme can’t pre-load your filters because it doesn’t know your products yet. Turn them on once and Operator renders them instantly.
Step 1 — Open the filter settings
Install the free Shopify Search & Discovery app (Apps → search “Search & Discovery” → Install — most stores already have it), open it, and click the Filters tab. Availability and Price are on by default.
Step 2 — Add the filters you want
Click Add filter and pick from the built-in options — these work instantly because Shopify already has the data. Then click Save and refresh a collection page.
| Filter | What it does | Great for |
|---|---|---|
| Availability | In stock / out of stock | Every store |
| Price | Min–max range slider | Every store |
| Product type | Your product categories | “Keyboards”, “Mugs”, “Shoes” |
| Vendor | The brand on each product | Brand filtering |
| Product tag | Any tag you add to products | “New”, “Sale”, “Organic” |
| Color (variant option) | Filters by your Color option | Renders as swatches |
| Size / other options | Any variant option you sell | Size, Capacity, Speed |
Drag filters to reorder them — that’s the order shoppers see. You can have up to 25 filters.
Step 3 (optional) — Custom filters like Weight, Material, Roast
For anything Shopify doesn’t track by default, add it once as a metafield, then filter on it:
- Settings → Custom data → Products → Add definition. Name it (e.g. Weight, Material, Roast level); type Single line text (or Integer/Decimal for numbers). Tick “Storefront access” — without it the metafield can’t be filtered.
- Open a few products → Metafields → fill in the value (e.g. Material = “Aluminum”).
- Back in Search & Discovery → Filters → Add filter → choose your new metafield → Save.
What each industry typically turns on
| Industry | Typical filters |
|---|---|
| Apparel | Availability, Price, Color, Size, Material*, Brand |
| Coffee / food | Availability, Price, Roast*, Origin*, Caffeine*, Type |
| Electronics / hardware | Availability, Price, Brand, Type, Capacity, Wattage* |
| Beauty | Availability, Price, Skin type*, Scent*, Brand |
| Pets | Availability, Price, Pet*, Life stage*, Brand |
* = added once as a metafield (Step 3). Everything else is built in.
Color swatches (automatic)
Add a Color filter and Operator shows real color swatches automatically (same name-to-hex logic as product swatches). To control exact swatch colors, set them once under Settings → Custom data → Metaobjects → Color — Shopify’s native swatch system; image swatches (patterns/textures) work too.
Filters apply with AND between filters and OR within a filter (e.g. Red OR Blue, AND Under $50). Collections with over 5,000 products don’t show filters (a Shopify limit). You never edit the theme for any of this — enable filters here and Operator renders them.
60-second version: Apps → Search & Discovery → Filters → Add filter → tick Product type, Vendor, Color (and any others) → Save → refresh your collection page. Done.
Sorting
Sorting (price, newest, best-selling, A–Z, etc.) is built in and always available on collection and search pages — no setup needed.
The single-H1 banner
As covered under Collection banner, the banner provides the collection title as the page’s one H1, plus the eyebrow, breadcrumb and description — with adjustable height, padding, alignment and per-device overrides.
Cart & checkout
Choose how the cart behaves, add upsells and gift wrapping, and nudge shoppers toward free shipping — all native.
Cart style
Under Theme settings → Cart → Cart style pick one of:
- Drawer — a slide-out panel; the shopper stays on the page (default).
- Page — a full cart page at
/cart. - Notification — a quick confirmation popup on add, keeping the shopper in flow.
Free-shipping bar
Turn on the free-shipping progress bar and set the threshold (cart_free_ship_threshold). It shows shoppers how much more to add to qualify and fills as they get closer.
Cart upsell
The built-in Upsell engine (cart_upsell_mode) recommends add-ons inside the cart:
- Auto — suggests complementary products automatically.
- Manual — you choose exactly which products to offer.
- Off — no upsells.
For a full cross-sell grid on the cart page (or anywhere), add the Cart — Upsell section (cart-upsell): it shows recommended or fallback-collection products with quick-add and choose-options buttons.
Gift wrapping
Enable gift wrap in the Cart settings to offer an optional paid gift-wrap add-on at checkout. Pair it with order notes (also a Cart toggle) for gift messages.
For a richer, placeable experience, add the Cart — Gift wrapping section (gift-wrapping): it offers a paid gift-wrap product add-on (or a free gift-note checkbox) plus an optional gift-message field with a custom label and placeholder.
Free-shipping bar, in-cart upsells, gift wrapping and notes are all part of Operator. You do not need a cart app to use them.
Customization & best practices
Colors & fonts
Set brand colors and fonts once in Theme settings — every section inherits them, so the store stays consistent. Prefer the palette presets to get a coherent skin, then adjust the brand red if needed. Leave button colors blank to inherit the accent automatically.
One H1 per page
Each page should have exactly one <h1>. On collections and most pages the banner owns it; on the homepage your hero should carry it. Set every other section’s heading to H2/H3. This is good for SEO and accessibility, and Operator’s sections are built around it.
Image sizes
| Use | Recommended |
|---|---|
| Hero / full-bleed banners | 2400×1200 px+ (landscape), < 400 KB after compression. |
| Product images | Square or portrait, 1600–2000 px on the long edge, consistent ratio across the catalog. |
| Collection / category tiles | 1200×1500 px (portrait) works well with the default card ratio. |
| Logo | Transparent PNG/SVG; let logo_width size it. |
Always upload at 2× the display size for retina sharpness and let Shopify generate responsive sizes. Keep aspect ratios consistent so grids stay tidy (no layout shift).
Performance tips
- Don’t add external fonts or scripts. Operator self-hosts its fonts; loading Google Fonts or app scripts will slow you down and is unnecessary.
- Use Operator’s native sections instead of apps wherever possible (reviews, FAQ, sliders, countdowns, comparison tables) — fewer third-party requests.
- Compress images before upload; let the first hero image load eagerly and everything below lazy-load (Operator handles this).
- Keep the Advanced custom code fields lean.
Accessibility
Operator targets WCAG AA: visible focus states, ARIA on interactive components, keyboard-operable menus/drawers, and reduced-motion support. To keep it accessible, maintain strong color contrast (be careful if you lighten text or darken the red), write descriptive image alt text, and use real heading levels rather than styling text to look like headings.
Shadow Suite (optional)
Operator is designed to work perfectly on its own. If you also install the optional Shadow Suite app, extra features light up automatically — no theme edits required.
What lights up
- Reviews & ratings — the Reviews section and the product Rating block become fully data-driven, reading real review data from Suite metafields and emitting aggregate-rating structured data.
- Loyalty — a loyalty pill/points display appears (the Suite — Loyalty pill block) when the Suite is active.
How it works
Operator detects the Suite via metafields and the Enable Suite hooks toggle (Theme settings → License). When the app is present, the relevant areas hydrate with live data; when it is absent, those areas gracefully fall back to the theme’s native presentation. If you want the Suite to own structured data, enable Let Shadow Suite handle structured data under SEO to prevent duplicate schema.
You never need Shadow Suite to run Operator. It is purely additive. Reviews, ratings and the rest have sensible native behavior without it.
Troubleshooting & FAQ
How do I edit a section’s text or images?
Open Customize, pick the page from the top dropdown, click the section in the left panel, and edit its fields. Changes preview live; click Save when done.
A section looks empty or shows placeholders
Most likely it isn’t connected to content yet. Open the section and choose a collection, products, or blog, or add blocks / upload images. Featured-collection and collection-list sections show placeholders until you select a collection.
My color swatches aren’t the right color
Operator maps option names to colors. If a name isn’t a standard color word, set an explicit Shopify swatch (color or image) on that variant in admin so the exact shade displays.
The mega menu isn’t showing
Check three things: (1) Enable mega menu is on under Theme settings → Header; (2) your menu is nested correctly in Navigation (Level 1 → Level 2 columns → Level 3 links); (3) the top-level item is set to open as a mega panel in the Header section.
My homepage looks different from the demo
Demos are specific homepage presets. Select the preset you want from the page dropdown in the editor, then swap in your own images, text and products.
Where do collection filters come from?
From Shopify’s free Search & Discovery app. Install/configure filters there; Operator styles them automatically.
How do I change the cart from a page to a drawer?
Theme settings → Cart → Cart style → choose Drawer, Page, or Notification.
Do I need any apps?
No. Reviews, FAQ rich results, before/after sliders, mega menus, countdowns, wishlists, compare, upsells and more are native. Apps are entirely optional.
How do I apply a different product layout?
Products → open a product → Theme template → pick one of the 22 Operator templates. To preview without assigning, add ?view=template-name to the product URL.
Will the theme slow my store down?
No — that’s the point. Operator self-hosts fonts, uses vanilla JS, lazy-loads media, and avoids external scripts. The fastest setup is to use native sections and avoid adding extra fonts/apps.
Support
We’re here to help you get the most out of Operator.
Email support
support@getfknnuts.com
Include your store URL and a screenshot of the section/setting in question.
Contact page
You can also reach us through the contact form on the store where you purchased Operator.
Before you write
Check the Troubleshooting & FAQ — most questions are answered there.
Support details are placeholders for the store owner to finalize before the Theme Store listing goes live.