Crux — დოკუმენტაცია

Shopify თემა · ავტორი: Weblorium · ვერსია 1.0.0

Everything you need to set up and customize Crux: installation, theme settings, every section and block, translations, answers to common questions, and how to reach our support team.

გჭირდებათ დახმარება? Support ticket-ის გახსნა

Getting started

Crux is a bold, playful Shopify theme built for food, snack, and lifestyle brands. It is built on Online Store 2.0 features: JSON templates, sections, blocks, and section groups. This means you can rearrange almost every page in the theme editor without touching code.

Install Crux

  1. Open the Crux listing in the Shopify Theme Store. You can also go to Online Store > Themes in your Shopify admin and visit the Theme Store from there.
  2. Click Try theme to add Crux to your theme library. You can customize and preview a trial copy before you buy it. Paid themes must be purchased before you can publish them.
  3. In Online Store > Themes, find Crux in your theme library and click Customize to start setting it up.
  4. When your store looks the way you want, click Publish to make Crux your live theme.

Duplicate before you edit code

A duplicate gives you a working backup that you can restore at any time. To duplicate Crux:

  1. From your Shopify admin, go to Online Store > Themes.
  2. Next to Crux, click the … (Actions) button, then click Duplicate.
  3. Make your code changes in the copy, preview them, and publish the copy only when you're happy with the result.

Theme editor basics

You customize Crux in the theme editor. To open it, go to Online Store > Themes and click Customize next to Crux.

  • Choose a page to edit

    Use the page selector at the top of the editor to switch between templates, for example Home page, Products > Default product, or Collections > Default collection.

  • Sections and section groups

    The sidebar lists the sections of the current template, along with three section groups that appear on every page: Header (the top bar and the header), Footer, and Overlays (the promo popup, the age verifier, and the back to top button).

  • Add, reorder, hide, and remove

    Click Add section or Add block to add content. Drag the handle next to a section or block to move it. Click the eye icon to hide it without deleting it, or open it and click Remove.

  • Theme settings

    Open Theme settings from the gear icon at the top left of the editor. These settings, such as colors, fonts, and cart behavior, apply to your whole store.

  • App blocks and app embeds

    Many Crux sections accept app blocks, so apps can place content directly inside them. App embeds are managed from the App embeds icon.

  • Dynamic sources

    Many settings can be connected to a metafield with the Connect dynamic source icon, so their content changes per product, collection, or page.

  • Templates

    To give some products or pages a different layout, open the page selector, choose the template type, and click Create template. Then assign the new template to the product or page under Theme template in your Shopify admin.

  • Preview and save

    Use the device toggle at the top of the editor to preview your store on mobile, and click Save when you're done.

Setup checklist

  1. Upload your logo and favicon in Theme settings > Logo and favicon.
  2. Adjust your color schemes and fonts in Theme settings > Colors and Typography.
  3. Build your menus in Content > Menus (shown as Online Store > Navigation in some admins): a main menu for the header, a footer menu, and, if you want, a menu of collections for collection pages.
  4. Install the free Shopify Search & Discovery app to set up filters, related products, and complementary products.
  5. Add your store policies in Settings > Policies so they appear in the footer.
  6. Add your social media links in Theme settings > Social media.
  7. Replace the placeholder content on the home page, product page, and other templates.
  8. Place a test order to check your cart and checkout.

Theme settings

Theme settings apply to your entire store. Open them from the gear icon at the top left of the theme editor. The categories below appear in the same order as in the editor.

  • Logo and favicon
    • Logo — the image shown in the header, and in the footer when you don't choose a footer logo. If you leave it blank, your store name is shown as text. A transparent PNG or SVG works best.
    • Logo width — the width of the header logo, from 50 to 300 px.
    • Favicon — the small icon shown in browser tabs and bookmarks. A 32 x 32 px PNG is recommended.
  • ColorsYour color schemes and the highlight colors.
    • Color schemes — the named sets of colors that every section chooses from. See Color schemes.
    • Highlight background — the color of the paint stroke edges and of highlighted badges.
    • Highlight text — the text color on highlighted badges.
  • TypographyCrux uses three fonts, all chosen from the Shopify font library, which includes system fonts that load instantly.
    • Headings: Font — the font for headings. The default is Titan One.
    • Headings: Size scale — makes all headings smaller or larger, from 80% to 140%.
    • Body: Font — the font for paragraphs, buttons, and forms. The default is Barlow Semi Condensed.
    • Body: Size scale — makes body text smaller or larger, from 90% to 130%.
    • Accent: Font — applies to the marquee, cart titles, and small uppercase labels. The default is Barlow Condensed.
  • Layout
    • Page width — the maximum width of page content, from 1000 to 1600 px.
    • Page margin — space on the left and right of the page on large screens, from 16 to 64 px.
  • CornersEach setting sets the corner radius, from 0 px (square) to 40 px (very round).
    • Buttons — the corners of buttons.
    • Inputs — the corners of form fields, such as search, email, and quantity fields.
    • Cards — the corners of product cards and other cards.
    • Media — the corners of images and videos.
  • Product cardsProduct cards appear on collection pages, in search results, and in product sections such as Featured collections.
    • Image ratio — Square, Portrait, or Landscape.
    • Image fit — Fit shows the whole image. Fill crops the image to fill the card.
    • Show second image on hover — shows the product's second image when a visitor hovers over the card.
    • Show short description — uses the product subtitle metafield, or the start of the description when it is empty.
    • Show vendor — shows the product vendor.
    • Show rating — shows the product rating metafields that review apps fill in.
    • Show add to cart button — adds a button to each card. Products without variants are added to the cart directly. Products with variants show a Choose options button that opens the product page.
    • Show quick view button — adds a button that opens the product in a dialog, where customers can choose options and add the product to the cart. See Quick view.
    • Show sale badge — shows a badge on products with a compare-at price.
    • Sale badge content — Percentage saved or Sale. Appears when Show sale badge is on.
    • Show sold out badge — shows a badge on products that are sold out.
    • When a product option is connected to a metafield with swatches, product cards also show a row of color or image swatches for that option. See How do I show color swatches?
  • AnimationsVisitors who turn on reduced motion in their device settings don't see these animations.
    • Reveal content on scroll — fades sections in as visitors scroll down the page.
    • Hover effects — adds subtle movement to buttons and product cards when visitors hover over them.
    • Page transitions — fades between pages in browsers that support view transitions.
  • Cart
    • Cart type — Drawer opens the cart in a panel on the side of the screen. Page sends customers to the cart page. See Cart drawer and cart page.
    • Show order notes — lets customers add a note to their order.
    • Show gift wrap option — adds a checkbox that saves a gift wrap request on the order as a cart attribute.
    • Show product recommendations — suggests related products based on the first item in the cart.
    • Show free shipping progress — shows customers how much more they need to spend to get free shipping. Off by default. See Free shipping progress.
    • Free shipping threshold — the minimum order amount for free shipping, in your store currency. Appears when Show free shipping progress is on.
  • Search
    • Show search suggestions — shows suggested search terms, products, collections, pages, and blog posts while visitors type in the search field.
  • Currency format
    • Show currency codes — adds the currency code to prices, for example $10.00 USD. Cart and checkout prices always show currency codes.
  • Social mediaPaste the full link to each profile. Icons for the profiles you add appear in the footer Brand block, in the mobile menu, and on the password page.
    • Facebook
    • Instagram
    • TikTok
    • X (Twitter)
    • YouTube
    • Pinterest

Color schemes

A color scheme is a named set of colors. Every section has a Color scheme setting, so you can change a section's look by picking a different scheme. When you edit a scheme, every section that uses it updates.

Crux includes five schemes: Scheme 1 (cream), Scheme 2 (red), Scheme 3 (green), Scheme 4 (brown), and Scheme 5 (yellow). To edit one, go to Theme settings > Colors and click it. To create a new one, click Add scheme.

  • Settings in each color scheme
    • Background — the background color of sections that use the scheme.
    • Text — the main text and icon color.
    • Accent — applies to eyebrows, links, and highlighted heading text. An eyebrow is the short label shown above a heading.
    • Button background — the fill color of solid buttons.
    • Button label — the text color of solid buttons.
    • Card background — the background of cards, such as product cards and testimonial cards.
    • Card text — the text color inside cards.

Sections

Sections are the building blocks of each page. Most sections share these settings, so they are not repeated in every description below:

  • Color scheme: the colors of the section.
  • Top padding and Bottom padding: space above and below the section, from 0 to 160 px.
  • Eyebrow, Heading, and Text: an optional short label, a heading, and an introduction above the section content.

Banners and announcements

  • HeroA large opening banner with a two-line heading, text, and up to two buttons.
    • Image — a transparent PNG of your products works best. 2400 x 1200 px recommended.
    • Mobile image — replaces the image on small screens.
    • Image layout — Product cutout places the image inside the section, sized with Image width (40% to 100%). Full width fills the section with the image.
    • Minimum height — the section height as a percentage of the screen height (vh), from 40% to 100%. It applies on tablets and computers; on phones the section fits its content.
    • Accent heading — the first line of the heading, shown in the accent color. Heading is the second line.
    • Heading level — H1 or H2. Use H1 only once per page, for the main heading.
    • Button label, Button link, Second button label, and Second button link.
  • SlideshowUp to eight full-width slides, each with its own image, text, and button.
    • Minimum height — Small, Medium, or Large.
    • Show arrows and Show dots — navigation controls.
    • Auto-rotate slides — off by default. Rotation pauses while a visitor hovers or focuses the slideshow, and stays off for visitors who prefer reduced motion.
    • Change slides every — from 3 to 10 seconds.
    • Slide (block) — Image, Mobile image, Eyebrow, Heading, Text, Button label, Button link, Alignment (Left, Center, or Right), Text position (Top, Middle, or Bottom), and Color scheme.
  • MarqueeA band of short messages that scrolls across the screen. It can also be added to the header and footer groups.
    • Icon — the symbol between messages: None, Arrow, Star, Bolt, Heart, or Leaf.
    • Text size — Small, Medium, or Large.
    • Speed — the time for one full loop, from 5 to 60 seconds. Lower values move faster.
    • Direction — Right to left or Left to right.
    • Pause on hover — stops the band while a visitor hovers over it. Visitors can also pause it with the pause button, and visitors who reduce motion see a static band.
    • Text (block) — one message. Add up to 12.
  • CountdownA live timer that counts down to a launch, a sale, or an event.
    • Button label and Button link.
    • End date — use the format YYYY-MM-DD, for example 2026-12-31.
    • End time — 24-hour format HH:MM, for example 18:00.
    • Time zone offset — the difference between the end time and UTC, for example +01:00 or -05:00. Use +00:00 for UTC. See How do I set the countdown time zone?
    • When the countdown ends — Show a message (set the Ended message) or Hide the section. The timer never restarts on its own. Set a new end date to run another countdown.
  • Rich textA heading, text, and an optional button (Button label and Button link), aligned Left or Center.
  • Email signupA newsletter form with an Alignment setting. Each signup adds a subscriber to your customer list. You can also add this section to the footer group.

Products and collections

  • Featured collectionsA product grid with tabs. Each tab shows the products of one collection.
    • Products to show — from 3 to 12.
    • Columns on desktop — from 2 to 5.
    • Show view all button — links to the collection of the selected tab.
    • Collection (block) — a Collection and an optional Tab label. Leave the label blank to use the collection title. Add up to eight tabs.
  • Collection listA grid of collection cards. Add up to 12 Collection blocks.
    • Alignment — Left or Center.
    • Columns on desktop (2 to 5) and Columns on mobile (1 or 2).
    • Image ratio — Square, Portrait, or Landscape.
    • Show product count and Show view all button — the button links to your collections page.
  • Featured productShows one product with its images and buy buttons, so customers can buy without leaving the page.
    • Product, Media position (Left or Right), and Image fit (Fill or Fit).
    • Blocks — Product rating, Vendor, Title, Price, Text, Description, Inventory status, Variant picker, Purchase options, Quantity selector, Buy buttons, Pop-up guide, Trust badges, Nutrition facts, Custom Liquid, and app blocks. These work like the product page blocks.
  • Build your own boxLets shoppers fill a box with their favorite products and add everything to the cart in one click. You can add it to any page.
    • Collection — shoppers pick from the products in this collection. Products sold only with a subscription are left out.
    • Products to show — how many products from the collection appear, from 2 to 24.
    • Box size — how many items fill the box, from 2 to 24.
    • Require a full box — on by default. The add button stays disabled until the box is full. Turn it off to allow partly filled boxes.
    • Note — a short message above the button, for example “Save 10% on a full box.” The theme never applies discounts. If you promise one, create a matching automatic discount in your Shopify admin. See Does the box builder apply a discount?
    • Button label — the button text.
    • Shoppers can't add more of a product than you have in stock when Shopify tracks its inventory and stops selling at zero.
    • On phones, the box summary stays at the bottom of the screen, and shoppers can expand it to review their items.
  • Product pairsShows two products that go well together in each pair. Add up to eight Pair blocks.
    • First product and Second product.
    • First image and Second image — optional. Leave them blank to use the product images.
    • Note, Eyebrow, and Title — leave Title blank to use the title of the first product.
    • Button label and Button link — leave Button link blank to link to the first product.
  • Image hotspotsTag products in a lifestyle image, so customers can shop the look.
    • Image — pins are placed on this image. 1600 x 1200 px recommended.
    • Hotspot (block) — Horizontal position (distance from the left edge of the image), Vertical position (distance from the top edge), Title, Text, and Product, which shows the product title, price, and a link to the product. Leave Title blank to use the product title. Add up to eight.
  • Related productsCan only be added to product templates. Shopify generates related products from your store data, and they appear once enough data is available.
  • Recently viewed productsShows the products the visitor looked at most recently. The section stays hidden until there is something to show. The list is stored in the visitor's own browser.
    • Products to show — from 2 to 8.
    • Columns on desktop — from 2 to 5.

Storytelling

  • Ingredient calloutsA central product image surrounded by short callouts, for example ingredients or features, each pointing at the image with a hand-drawn arrow.
    • Image — 1:1 aspect ratio recommended.
    • Callout (block) — a Title and a short Text. Add up to six.
  • Comparison tableCompares your product with the alternatives, row by row, with check marks.
    • Intro — a Heading with a Left image and a Right image. Transparent PNGs work best.
    • Comparison — an Image, an Accent heading, a Heading, and the column headings: Feature column heading, Brand column heading (leave blank to use your store name), and Comparison column heading.
    • Colors — Color scheme, Panel color scheme for the table panel, and Show wavy edges.
    • Row (block) — a Feature, plus the Included in your product and Included in the alternative checkboxes. Add up to ten rows.
  • Before and afterTwo images of the same subject with a handle that customers drag to compare them.
    • Before image, Before label, After image, and After label.
    • Image ratio — Adapt to media, Square, Landscape, Portrait, or Wide.
    • Starting position — where the handle starts, from 10% to 90%.
  • Image with textAn image next to text, buttons, and a checklist.
    • Image, Second image (overlaps the corner of the first image), Badge, and Image position (Left or Right).
    • Blocks — Eyebrow, Heading, Text, Checklist (add one item per line in List items), Button (with Button style: Solid or Outline), Custom Liquid, and app blocks.
  • TestimonialsCustomer reviews in a scrolling row. Add up to 12 blocks.
    • Quote (block) — Quote, Rating (from 0 to 5 in half steps; set to 0 to hide the stars), Author, and Author photo.
    • Photo review (block) — Image, Rating, and Author.
  • Logo listLogos of press features, partners, or retailers. Add up to 12 Logo blocks.
    • Layout — Grid or Scrolling row.
    • Logo height — from 24 to 120 px.
    • Show logos in one color — recolors the logos to match the color scheme. Works best with transparent PNG or SVG logos.
    • Speed — for the scrolling row, the time for one full loop, from 10 to 90 seconds.
    • Logo (block) — an Image, a Link, and a Quote: a short line from the article, shown under the logo.
  • Trust badgesIcons with short reassurances, such as free shipping or secure checkout.
    • Layout — Icon above text or Icon beside text.
    • Show payment icons — adds the payment methods your store accepts.
    • Trust badge (block) — an Icon (Truck, Return arrows, Lock, Shield, Leaf, Box, Gift, Clock, Heart, Star, Bolt, Check mark, Envelope, or Question mark), a Title, and a Text. Add up to six.
  • FAQQuestions that open and close to reveal their answers.
    • Open the first question — shows the first answer when the page loads.
    • Question (block) — Question, Answer, and Answer from page. When you choose a page, its content appears in the answer.
    • Custom Liquid and app blocks are also supported.
  • Featured blogThe latest posts from one blog.
    • Blog, Alignment, and Posts to show (2 to 4).
    • Button label — links to the selected blog. Leave blank to hide the button.
    • Show featured image, Show date, Show author, and Show excerpt — what each blog post card shows.

Layout and utilities

  • Custom sectionAn empty section that you build from theme blocks. See Custom section and blocks.
  • Custom LiquidPaste app snippets or your own Liquid, HTML, CSS, and JavaScript to build advanced customizations. Code you add here is not covered by our support.
    • Liquid code — your code.
    • Make section full width — removes the page margins.
  • BreadcrumbsShows the path to the current page. Nothing is shown on the home page. You can add it to every template except the home page and the password page.
    • Text size — Small, Medium, or Large.
  • Contact formA form that sends messages to your store email. See Contact page and contact form.

Product page

The default product template contains Breadcrumbs, Product information, Testimonials, Comparison table, Related products, and Recently viewed products. Product information holds the media gallery and the buy box.

Product information

  • Section settings
    • Media ratio — Adapt to media, Square, or Portrait.
    • Image fit — Fill crops images to the frame. Fit shows the whole image.
    • Loop videos — restarts product videos when they end.
    • Enable image zoom — opens product images in a full screen view with previous and next navigation. See Image zoom.
    • Badge — appears on the first product image. Connect a metafield to change it per product. See How do I add a badge to some products only?
    • Show sticky add to cart bar — shows the price and an add to cart button at the bottom of the screen once the buy buttons scroll out of view. See Sticky add to cart bar.

Product blocks

Add, remove, and reorder these blocks inside Product information.

  • Product ratingShows the product rating metafields that review apps fill in.
  • Vendor, Title, and SKUThe product vendor, the product title, and the SKU of the selected variant.
  • PriceThe price, the compare-at price, and unit prices.
    • Show tax and shipping note — adds a note about taxes and shipping.
    • Show installment terms — shows Shop Pay Installments terms when they are available.
  • TextA short piece of rich text.
  • DescriptionThe product description.
  • Inventory statusStock messages. See Inventory status.
  • HighlightsA Heading and a list of key facts. Add one item per line in List items.
  • Variant pickerOption selectors.
  • Purchase optionsOne-time purchase and subscription choices. See Purchase options and subscriptions.
  • Quantity selectorLets customers choose how many to buy.
  • Buy buttonsThe add to cart button.
    • Show dynamic checkout buttons — customers see their preferred payment method, such as PayPal or Apple Pay.
    • Show gift card recipient form — lets customers send gift card products directly to a recipient with a personal message.
    • Show pickup availability — shows whether the product can be picked up at your locations.
    • Show pre-order button and Pre-order note — see Pre-order.
  • Back in stock requestSee Back in stock request.
  • Pop-up guideSee Pop-up guide.
  • Trust badgesSee Trust badges.
  • Collapsible tabA Heading that opens to show Content, Content from page, or both.
    • Open by default — shows the content when the page loads.
  • Nutrition factsA nutrition label table. See Nutrition facts.
  • Photo rowA Heading and up to four images, for example customer photos.
  • Complementary productsSee Complementary products.
  • ShareA share button that uses the device's share menu or copies the link. Add an optional second button with Help button label and Help button link, for example to your contact page.
  • Custom LiquidYour own Liquid or HTML code.
  • AppsApp blocks, for example from a reviews or subscriptions app.

Variant picker and swatches

The Style setting shows options as Pills (buttons) or as a Dropdown. Unavailable combinations are marked so customers can see them at a glance.

When a product option is connected to a category metafield that has swatches, for example a color option, Crux shows the swatches automatically:

  • With Pills, each value appears as a round color or image swatch, and the selected value is named next to the option name.
  • With Dropdown, a small preview of the selected swatch appears next to the option name.
  • Product cards show a row of swatches for the first option that has them.

Purchase options and subscriptions

The Purchase options block appears only for products with subscriptions or other purchase options. One-time purchase is listed first, followed by each subscription or other purchase option that you set up in your subscription app. Each option shows its price. If a product can only be bought with a subscription, the one-time option is hidden.

Purchase options also appear in quick view and in the Featured product section. See How do I sell subscriptions?

  • When an option costs less than a one-time purchase, it shows a “Save X%” badge. The percentage is calculated from your real plan prices.
  • When the selected option has 2 to 5 delivery frequencies, they appear as buttons. More than 5 appear in a dropdown.
  • Select subscription by default: product pages open on the first subscription plan. Customers can still switch to one-time purchase. A link that names a plan opens on that plan, and quick view never preselects a plan.
  • Show subscriptions first: lists the subscription options above one-time purchase. Shopify recommends showing one-time purchase first, so turn this on only if most of your customers subscribe.
  • Subscription benefits: add one benefit per line. They appear as a checklist under the first subscription option. Only list benefits that your subscription really offers.

Inventory status

Shows the real stock level of variants whose inventory is tracked by Shopify. Nothing appears when inventory is not tracked.

  • Low stock threshold: shows the remaining quantity, for example “Only 3 left in stock,” when it is at or below this number (0 to 50). Set to 0 to show only in stock and out of stock.
  • Show in stock message: shows “In stock” when stock is above the threshold.
  • Variants that are sold out but keep selling show “Out of stock, available to order.”

Pre-order

In the Buy buttons block, turn on Show pre-order button. This changes the button label to Pre-order when a variant with tracked inventory is sold out but its inventory policy keeps selling. The Pre-order note appears under the button, for example “Ships as soon as it is back in stock.”

To keep selling a sold-out variant, open the product in your Shopify admin and turn on Continue selling when out of stock for that variant. Pre-orders are placed and paid like regular orders.

Pop-up guide

A link that opens a pop-up, for example a size guide or care instructions. Set the Link label, an optional Pop-up heading (leave blank to use the link label), and the content: type it in Content, or choose a page in Content from page to reuse the same guide on many products. You can add several pop-up guides.

Nutrition facts

Shows a nutrition label table. Add the Nutrition facts block to Product information or to the Featured product section.

  • Heading: the name of the label, for example “Nutrition facts.”
  • Serving info: appears under the heading, for example “Serving size 20 g · 4 servings per bar.”
  • Calories: appears as a large first row.
  • Rows: one nutrient per line, written as Label | Amount | % Daily value, for example Total fat | 7 g | 9%. The % column is optional. Start a line with - to indent it under the line above, for example - Saturated fat | 5 g | 25%.
  • Footnote: appears below the table.
  • Show as collapsible: shows the heading as a row that opens the label, like the Collapsible tab block.

Trust badges

Up to three short reassurances under the buy buttons, each with an icon: First icon and First text, Second icon and Second text, and Third icon and Third text. Add an optional Heading, and turn on Show payment icons to show your accepted payment methods.

Back in stock request

Appears when the selected variant is sold out. Customers leave their email address, and Crux sends the customer's email and the product name to your store email, like the contact form, so you can follow up. Customize the Heading and Text.

Complementary products

Shows products that pair well with the current product, with a Heading and Products to show (1 to 6). To choose complementary products, use the Shopify Search & Discovery app. The block stays empty until you choose products there.

Sticky add to cart bar

When Show sticky add to cart bar is on, a bar with the product image, price, and an add to cart button slides in once the buy buttons scroll out of view, and hides again near the footer.

For products without variants, the button adds the product to the cart. For products with variants, a required subscription, or a gift card recipient form, the button scrolls back to the options, so customers always see what they are buying.

Image zoom

When Enable image zoom is on, customers can open product images in a full screen view and move between them with previous and next buttons, the arrow keys, or a swipe.

Quick view

When Show quick view button is on in Theme settings > Product cards, product cards get a quick view button. It opens the product in a dialog with its images, title, price, variant picker, purchase options, quantity selector, buy buttons, and a link to the full product page.

Cart drawer and cart page

Choose between a drawer and a page in Theme settings > Cart > Cart type. Both show the same content:

  • Each item with its image, options, subscription plan, price, and a quantity selector. Changes update the cart without reloading the page.
  • Applied discounts, the subtotal, and a note about taxes and shipping.
  • Show order notes: a field for an order note.
  • Show gift wrap option: a “Wrap as a gift” checkbox. When checked, the order shows the cart attribute “Gift wrap: Yes” under Additional details in your Shopify admin. This option doesn't add a fee. To charge for gift wrap, create a gift wrap product instead.
  • Show product recommendations: suggests related products based on the first item in the cart, under the heading “You'll love these too.”
  • Show free shipping progress: how much more the customer needs to spend to get free shipping, with a progress bar. See Free shipping progress.
  • Cart drawer

    Settings: Color scheme. To see the drawer while you edit, click the cart icon in the theme editor preview.

  • Cart (cart page)

    Color scheme and padding, plus Custom Liquid and app blocks. The default cart template also includes Breadcrumbs and Recently viewed products.

Free shipping progress

This feature is off by default. To turn it on, go to Theme settings > Cart, turn on Show free shipping progress, and enter your Free shipping threshold. Use the same minimum order price as your free shipping rate in Settings > Shipping and delivery.

The cart drawer and the cart page then show how much more the customer needs to spend to get free shipping, with a progress bar. Once the cart reaches the threshold, a message confirms that free shipping is unlocked.

  • Enter the threshold in your store currency. It is compared with the cart subtotal after discounts.
  • Customers who shop in another currency see the amount converted at the current exchange rate. If you set fixed shipping rates per market, the converted amount may not match them exactly.
  • The bar is hidden when the cart is empty or when nothing in the cart needs shipping.

Blog, pages, and contact form

  • Blog postsThe blog page shows a grid of posts.
    • Posts per page — from 3 to 24.
    • Columns on desktop — from 2 to 4.
    • Highlight first post — shows the first post on each page larger on tablet and desktop.
    • Show tag filter — lets readers filter posts by tag.
    • Show featured image, Show date, Show author, and Show excerpt — what each blog post card shows.
  • Blog postA single article. When comments are turned on for the blog in your Shopify admin, readers can leave comments below the post.
    • Show featured image — with an Image ratio of Adapt to media, Landscape, or Wide.
    • Show date, Show author, Show tags, and Show share button.
  • PageShows the title and content of a page that you create in Online Store > Pages. You can add any other section below the page content.
    • Title alignment — Left or Center.
    • Color scheme and padding.
  • 404 pageShown when a visitor opens a link that doesn't exist. It includes a message, a search field, and a button that links to your products. Settings: Color scheme and padding. To change the message, edit the storefront text (see Translations and RTL).
  • Password pageShown while your store is password protected. Turn password protection on or off in Online Store > Preferences.
    • Heading — the main heading, for example “Opening soon.” The message under the heading comes from the password protection settings in your online store preferences.
    • Show email signup — with its own Heading and Text, so visitors can join your mailing list before you open.
    • Show social media icons — add your profiles under Social media in theme settings.
  • Gift cardThe page customers receive with their gift card code. It follows your theme settings.

Contact page and contact form

To create a contact page, go to Online Store > Pages, add a page, and choose contact as its Theme template. The contact template shows your page content followed by a Contact form section. You can also add the Contact form section to other templates.

Messages are sent to your store email. Build the form from these blocks (up to 20):

  • Text field

    A single-line field. Autofill helps browsers fill in a Name or Company.

  • Email field

    The first email field is sent as the customer's email address, so it is always required. If the form has no email field, one is added automatically.

  • Phone field

    A phone number field.

  • Multi-line text field

    The first multi-line text field is sent as the message.

  • Dropdown

    A list of choices. Add one option per line in Options.

  • Checkbox

    Leave Options blank for a single checkbox, for example a consent. Add one option per line to show a group of checkboxes. Required applies to single checkboxes only.

  • Heading

    A heading that groups the fields below it.

  • Paragraph

    A short instruction or note between fields.

Overlays

The Overlays group holds sections that float above the page on every page of your store. Each can be added only once. In the theme editor, the promo popup and the age verifier open while their section is selected.

  • Promo popupA popup with an image, a message, and either an email signup form or a button. It is off by default.
    • Show popup — turns the popup on.
    • Delay — seconds after the page loads before the popup opens, from 0 to 30.
    • Show again after — days before a visitor who closed the popup sees it again, from 1 to 90. Visitors who sign up do not see it again.
    • Show on — Home page only or All pages.
    • Image, Heading, and Text — the popup content.
    • Call to action — Email signup form (each signup adds a subscriber to your customer list) or Button, with a Button label and Button link.
    • Color scheme — the colors of the popup.
  • Age verifierVisitors see this dialog before they can use the page. It is off by default.
    • Enable age verification — turns the dialog on.
    • Minimum age — from 13 to 30.
    • Remember for — days before a visitor who confirmed their age is asked again, from 1 to 90.
    • Show logo — shows your logo in the dialog.
    • Heading and Text — use [age] to insert the minimum age. Leave blank to use the default text.
    • Confirm button label and Decline button label — the two button labels.
    • Decline link — sends visitors who decline to this link. Leave blank to show the decline message instead.
    • Decline message — the message for visitors who decline. Use [age] to insert the minimum age.
    • Color scheme — the colors of the dialog.
  • Back to topA floating button that appears once the visitor scrolls past the first screen.
    • Show back to top button — on by default.
    • Position — Left or Right.
    • Color scheme — the colors of the button.

Custom section and blocks

Custom section is an empty section that you build from theme blocks. Use it to create layouts that no other section offers. Add it with Add section > Custom section, then add blocks to it.

  • Custom section
    • Content width — Narrow or Page width.
    • Alignment — Left or Center.
    • Gap — the space between blocks, from 0 to 80 px.
  • Column and RowGroup blocks that hold other blocks. Nest them to build columns and rows.
    • Direction — Column or Row.
    • Alignment — Left, Center, or Right.
    • Gap and Padding — from 0 to 80 px.
  • Heading
    • Heading — the heading text.
    • Heading level — H1, H2, or H3. Use H1 only once per page, for the main heading.
    • Heading size — Extra large, Large, Medium, or Small, set separately from the level.
    • Alignment — left, center, or right.
  • Text
    • Text — the text itself.
    • Text style — Body, Large, Small, or Eyebrow.
    • Alignment — left, center, or right.
  • Button
    • Button label and Button link — the button text and where it leads.
    • Button style — Solid or Outline.
  • Image
    • Image — the image to show.
    • Width — from 20% to 100%.

Metafields and apps

  • Product subtitle

    With Show short description on, product cards show the product's subtitle metafield (descriptors.subtitle). When it is empty, the start of the product description is shown.

  • Product ratings

    Review apps that fill in Shopify's product rating metafields (reviews.rating and reviews.rating_count) show stars in the Product rating block and, with Show rating on, on product cards.

  • Product badge

    Connect a metafield to the Badge setting of Product information to show different text on each product.

  • Nutrition facts

    Connect product metafields to the Rows, Serving info, and Calories settings of the Nutrition facts block to show each product's own values. See How do I show different nutrition facts for each product?

  • Swatches

    Product options connected to category metafields with swatches show color or image swatches. See How do I show color swatches?

  • Search & Discovery

    Filters on collection and search pages, and the products in the Complementary products block, are managed in the free Shopify Search & Discovery app.

  • App blocks

    Apps can add blocks to Product information, Featured product, Image with text, FAQ, Custom section, Column and Row blocks, the Cart section, and the Footer.

Translations and RTL

Crux includes translations for English, French, Italian, German, and Spanish. Both the storefront text, such as button labels and cart messages, and the theme editor labels are translated.

Change storefront text

To change built-in text, for example “Add to cart” or the 404 message, go to Online Store > Themes, click the … (Actions) button next to Crux, and click Edit default theme content. Search for the text you want to change, edit it, and click Save.

Sell in more languages

  1. Go to Settings > Languages, add a language, and publish it.
  2. Install the free Shopify Translate & Adapt app to translate your own content: products, collections, pages, menus, and the text you entered in theme sections.
  3. Turn on Show language selector in the header, top bar, or footer so customers can switch languages.

Right-to-left languages

Crux supports right-to-left (RTL) languages, such as Arabic and Hebrew. When a customer views your store in an RTL language, the layout mirrors automatically: text, menus, drawers, sliders, and arrows switch direction. Crux doesn't include RTL translations, so add them with Translate & Adapt.

Accessibility and performance

Accessibility

Crux is built to be usable by everyone, including people who use a keyboard or a screen reader:

  • A “Skip to content” link, a clear heading structure, and labeled landmarks and forms.
  • Menus, drawers, dialogs, filters, and sliders work with a keyboard, and every interactive element has a visible focus outline.
  • Cart updates and other changes are announced to screen readers.
  • Visitors who turn on reduced motion don't see animations. The slideshow doesn't rotate on its own by default, and the marquee has a pause button.

Keep your store accessible

  • Add alt text to your images in Content > Files or in the image picker.
  • Keep enough contrast between text and background colors in your color schemes.
  • Use one H1 heading per page. The Hero section and the Heading block have a Heading level setting for this.
  • Use descriptive button and link labels, such as “Shop snacks” instead of “Click here.”
  • Add captions to videos that contain speech.

Performance

Crux is built to load quickly:

  • No JavaScript frameworks or libraries. Scripts load deferred, and scripts for optional features, such as quick view and search suggestions, load only when you turn those features on.
  • Images are responsive, so each device downloads a suitable size. Images below the first screen load only when visitors scroll near them.
  • The heading and body fonts are preloaded. Product recommendations load only when they scroll into view, and videos and 3D models load only when played.

Tips for a fast store

  • Upload images at the recommended sizes shown in the section settings, and compress them before you upload them.
  • Remove apps you don't use. Apps and code in Custom Liquid can slow down your store.
  • System fonts load instantly, so choose one for body text if speed is your priority.
  • Check the web performance report in your Shopify admin after major changes.

FAQ

How do I add a mega menu?

In Content > Menus, give a top-level item in your main menu some nested links. Then, in the theme editor, select Header, click Add block > Mega menu, and type the name of that top-level item in Menu item. Its dropdown becomes a full-width panel with the nested links as columns. You can add two promo images to each mega menu. See Mega menu.

How do I show color swatches?

Crux shows swatches for product options that are connected to a category metafield with swatch values:

  1. In your Shopify admin, open the product and set its Category, for example a clothing or food category.
  2. In the Variants area, add or edit an option such as Color and connect it to the matching category metafield. Choose its values from the metafield entries.
  3. To set or change a value's color or image, edit its entry in Content > Metaobjects.

The swatches then appear in the Variant picker block (use the Pills style for round swatches) and on product cards. To show swatches in collection filters, choose the swatch display for that filter in the Search & Discovery app. Options that are not connected to a metafield appear as text pills.

How do I sell subscriptions?

Install a subscription app, such as the free Shopify Subscriptions app, and create a subscription plan for your products. Crux then shows a one-time purchase option and each subscription option, with prices, through the Purchase options block.

This block is already in the default product template. If you removed it, select Product information and click Add block > Purchase options. If your subscription app adds its own app block, use either the app block or the Purchase options block, not both.

Why is the Recently viewed products section empty?

The section stays hidden until the visitor has viewed at least one product. The list is stored in each visitor's own browser, so every visitor sees their own products.

How do I change the fonts?

Go to Theme settings > Typography. Choose a Font for Headings, Body, and Accent from the Shopify font library, and adjust the Size scale for headings and body text. Fonts that are not in the Shopify font library require code changes. For those, we recommend that you hire a Shopify Partner (opens in a new tab).

How do I turn off or hide the age verifier?

The age verifier is off by default. If you turned it on, open the Overlays group in the theme editor, select Age verifier, and clear Enable age verification. You can also hide or remove the section.

While the section is selected in the theme editor, the dialog stays open so you can edit it. Select a different section to close it.

Why doesn't the promo popup appear?

Check that Show popup is on in the Promo popup section of the Overlays group, and check Show on: with Home page only, the popup appears only on the home page. After a visitor closes the popup, it stays hidden for the number of days in Show again after, and visitors who sign up don't see it again. To test it as a new visitor, open your store in a private browser window.

How do I set the countdown time zone?

The Countdown section counts down to an exact moment, which is the same for every visitor. Enter the End date (YYYY-MM-DD), the End time in 24-hour format (HH:MM), and the Time zone offset of the place where that time applies.

For example, for a sale that ends December 31, 2026, at 6:00 PM in New York, enter 2026-12-31, 18:00, and -05:00. The offset doesn't change for daylight saving time, so use the offset that applies on the end date. For example, New York is -04:00 in summer.

When the countdown ends, it shows the Ended message or hides the section, depending on When the countdown ends. It never restarts on its own. Set a new end date to run another countdown.

How do I translate my store or change the theme's text?

Crux is translated into English, French, Italian, German, and Spanish. To change built-in text, use Edit default theme content in Online Store > Themes. To sell in more languages, add them in Settings > Languages and translate your content with the Translate & Adapt app. See Translations and RTL.

How do I add filters to collection pages?

Install the free Shopify Search & Discovery app and add filters under Filters. Make sure Enable filtering is on in the Collection page and Search results sections.

Why do promo tiles disappear?

Promo tiles are hidden while a filter or a different sort order is active, so they never land between unrelated products. Clear the filters and the sort order to see them again.

How do I show star ratings?

Install a product reviews app that fills in Shopify's product rating metafields. Most popular review apps do. Then add the Product rating block to Product information, and turn on Show rating in Theme settings > Product cards to show stars on product cards.

How do I add a size guide or care instructions?

Add a Pop-up guide block to Product information. Set the Link label, for example “Size guide,” and add the guide in Content or choose a page in Content from page. Using a page lets you update the guide in one place for all products.

How do I show different nutrition facts for each product?

Store the values in product metafields and connect them to the Nutrition facts block:

  1. In your Shopify admin, go to Settings > Custom data > Products and click Add definition. Create a definition for each value you want to change per product, for example “Nutrition rows” as multi-line text, and “Serving info” and “Calories” as single-line text.
  2. Open each product and fill in its metafields. In “Nutrition rows,” add one nutrient per line, for example Total fat | 7 g | 9%.
  3. In the theme editor, select the Nutrition facts block. Click the Connect dynamic source icon next to Rows and choose your “Nutrition rows” metafield. Do the same for Serving info and Calories.

Products with an empty “Nutrition rows” metafield don't show the block. See Nutrition facts.

How do I take pre-orders?

Track inventory for the variant and turn on Continue selling when out of stock in your Shopify admin. Then, in the Buy buttons block, turn on Show pre-order button and edit the Pre-order note. When the variant is sold out, the button reads “Pre-order.”

Where do back-in-stock requests go?

Requests from the Back in stock request block are emailed to your store email, like contact form messages. Each request includes the customer's email address and the product name, so you can contact the customer when the product is available again. Crux doesn't send restock emails automatically.

How do I switch between the cart drawer and the cart page?

Go to Theme settings > Cart and set Cart type to Drawer or Page.

Does the box builder apply a discount?

No. The Build your own box section adds the products to the cart at their regular prices. If its Note promises a discount, for example “Save 10% on a full box,” create a matching automatic discount in Discounts in your Shopify admin.

For example, give a percentage off the products in the box's collection, with a minimum quantity of items equal to your Box size. Shopify applies the discount to every cart that meets its conditions, not only to boxes. See Build your own box.

Why don't customers see the free shipping bar?

Check that Show free shipping progress is on in Theme settings > Cart. It is off by default. Then check that Free shipping threshold is more than 0.

The bar is also hidden when the cart is empty or when nothing in the cart needs shipping, for example a cart with only gift cards. See Free shipping progress.

How do I add a badge to some products only?

In Product information, click the Connect dynamic source icon next to Badge and choose a product metafield, such as a single-line text metafield named “Badge.” Then fill in that metafield on the products that need a badge. Products with an empty metafield show no badge.

Why don't the country and language selectors appear?

Selectors appear only when your store sells in more than one country or language. Add countries in Settings > Markets and publish languages in Settings > Languages. Then check that the selectors are turned on in the header, top bar, or footer.

Will I lose my changes when I update Crux?

When a new version is available, Shopify shows a notification in your theme library. Updating adds the new version to your theme library as a copy, and the changes you made in the theme editor carry over. Changes made directly in the theme code don't carry over, which is one more reason to keep code edits to a minimum and to duplicate your theme first.

Can you customize Crux for me?

Our support covers questions about the theme and fixes for bugs in its original code, but it doesn't include custom design or code changes. For custom work, we recommend that you hire a Shopify Partner (opens in a new tab). Always duplicate your theme before you or a developer edit its code.

How do I get support?

Send us a request through the Crux support form. Our team replies within two business days. See Support for what is covered.

Support

We're here to help you get the most out of Crux. Contact us through the Crux support form. We reply to every request within two business days, Monday through Friday, excluding public holidays.

What support covers

  • Questions about Crux's theme settings, sections, and blocks.
  • Help with setting up features that are included in the theme.
  • Bugs in the theme's original code, such as a broken layout, a dead link, or a feature that doesn't work as described. We fix bugs promptly and treat critical bugs as our top priority.
  • Questions about Crux updates.

What support doesn't cover

  • Custom design work or code changes, including changes to Liquid, CSS, or JavaScript files.
  • Problems caused by code edits that you or a third party made to the theme.
  • Installing, configuring, or fixing third-party apps. If an app doesn't work well with Crux, we'll check whether the theme is the cause and point you to the app developer if it isn't.
  • Code added through Custom Liquid sections and blocks.
  • General store setup that isn't related to the theme, such as payments, shipping, taxes, domains, or marketing.

How to send a helpful request

  • Check the FAQ first. Many questions are answered there.
  • Include your store URL, for example your-store.myshopify.com, and the name of the theme copy you're working on.
  • Describe the problem, the page where it happens, and the steps that cause it.
  • Attach screenshots or a short screen recording.
  • If you edited the theme code, try to reproduce the problem on an unedited copy of Crux.
Support ticket-ის გახსნა

Changelog

Version 1.0.0

Initial release.

  • Sections for the home page, marketing, and every page template, including a Build your own box section, plus theme blocks for building your own layouts in a custom section.
  • Mega menus with promo images, a rotating top bar, and country and language selectors.
  • Product page with swatches, purchase options with subscription savings and benefits, nutrition facts, inventory status, pre-orders, back in stock requests, pop-up guides, trust badges, complementary products, a sticky add to cart bar, and image zoom.
  • Collection filtering and sorting, promo tiles, collection navigation, and load more or infinite scroll pagination.
  • Cart drawer or cart page with order notes, gift wrap, recommendations, and free shipping progress.
  • Promo popup, age verifier, and back to top button.
  • Translations for English, French, Italian, German, and Spanish, with right-to-left support.