Dexider Studios

CELLAR THEME · VERSION 1.0.0

Cellar
documentation

Everything you need to set up Cellar, our Shopify theme for wineries, distilleries and wine shops.

Getting started

  1. Add Cellar from the Shopify Theme Store to your theme library. Leave your current theme published while you set it up.
  2. Click Customize. Start in Theme settings (the paint-brush icon): add your logos, then check colors and fonts.
  3. Set up the tasting metafields so your product pages show tasting meters, pairings and serving notes.
  4. Build your homepage from the sections below, then check your product, collection and cart pages.
  5. Preview on a phone, then publish when you’re happy.

Cellar includes four color schemes: two deep navy schemes, a light parchment scheme and a deep burgundy scheme. Every section has a color scheme setting, so you can alternate them down the page. The fonts are Imbue for headings and Manrope for body text; both can be changed under Typography.

Cellar’s signature is a crest banner that hangs from the menu bar. It rolls up when a shopper uses the menu or clicks it, leaving a compact mark in the bar, and remembers its position as they browse.

  • Banner logo (stacked crest): your full logo, shown in the banner and on the age gate. Use a transparent PNG about 600 px tall.
  • Compact mark: a small symbol or monogram shown in the menu bar when the banner is rolled up.
  • Footer logo: shown in the footer’s brand block.
  • Logo style: choose Roll-down banner, or Inline logo for a simple logo in the menu bar that links home.

Choose your menu in the Header section. Menu items with child links open as a mega menu with an optional feature panel (image, eyebrow, heading and link). Float over the homepage hero lets the frosted menu bar sit on top of your first homepage image.

Menu swatches put a small glass of color beside dropdown links. Add a Menu swatch block, type the link’s title exactly as it appears in your menu (for example Red) and pick a color.

The cart icon is a small wine case that fills as bottles are added. Search opens predictive results as the shopper types; you can turn it off under Glass & motion.

Tasting data (metafields)

Cellar reads tasting details from product metafields in the cellar namespace. Create the ones you want in Shopify admin under Settings → Custom data → Products → Add definition, using exactly the namespace and key below. Turn on Storefronts access for each. Then fill them in at the bottom of each product page in your admin.

KeyTypeSuggested nameWhere it shows
cellar.bodyInteger (1–5)BodyTasting meter, Flavor Map position, taste profile
cellar.sweetnessInteger (1–5)SweetnessTasting meter, Flavor Map position, taste profile
cellar.tanninInteger (1–5)TanninTasting meter
cellar.acidityInteger (1–5)AcidityTasting meter
cellar.regionSingle line textRegionEyebrow above the product title and on product cards (falls back to the vendor)
cellar.vintageSingle line textVintageShown after the region, e.g. “2020”, “NV” or “Aged 7 years”
cellar.abvDecimalABV (%)Tasting banner on the homepage
cellar.pairingsList of single line textFood pairingsPairing chips under the tasting meters
cellar.serve_tempSingle line textServing temperatureChip under the tasting meters, e.g. “16–18°C”
cellar.glass_colorColorGlass glow colorColored glow behind the bottle on the product page
cellar.member_priceSingle line textMember price“Club members $54.40” badge beside the price

Every field is optional. Anything left blank is simply hidden, so a spirit with no tannin score shows no tannin meter. Use the same 1–5 scale for every product so the Flavor Map and taste profile compare them fairly.

Product pages

The Product information section is built from blocks you can reorder: eyebrow (region and vintage), title, price, text, tasting meters, variant picker, buy buttons, description, collapsible rows, Custom Liquid and app blocks.

  • Bottle images: transparent PNG bottle shots look best. Cellar places them on a soft glow in your cellar.glass_color.
  • Variants: vintages, sizes and gift options appear as pill buttons. The price, images and address bar update when a shopper changes them.
  • Collapsible rows: each row can show its own text or the content of a page, which is handy for shipping and age-verification policies you reuse.
  • Pickup availability shows automatically when local pickup is set up for the store.

Collections and the Flavor Map

Collection pages show a product grid with Shopify’s filters and sorting. Set up filters in the free Search & Discovery app; Cellar shows them automatically.

The Flavor Map is a 4 × 4 grid from light to bold and dry to sweet. When a shopper taps a square, the grid reorders so the closest wines come first, each with a match percentage. It uses the cellar.body and cellar.sweetness metafields (1–5). Turn it on and rename its labels in the Collection section settings. Products without both values move to the end.

Sections

Add these from Add section on any page that uses JSON templates:

  • Hero slideshow. Up to six full-screen slides, each with its own desktop and mobile image, text position, image darkening, a button and a second link. Autoplay and seconds per slide are in the section settings; visitors who prefer reduced motion never see it rotate.
  • The Pour (shop by style). One panel per style (red, white, rosé, sparkling, brandy…). Each panel links a collection and pours a glass in the wine and depth colors you choose; turn on Bubbles for sparkling.
  • Featured collection. 2, 4 or 8 products from one collection in even rows, with an optional View all link.
  • Tasting banner. A full-width image with a featured bottle. It shows the product’s vintage, ABV and tasting meters, and the button goes to that product unless you set a link.
  • Club tiers. Up to four membership tiers with perks and a button. Tick Highlight on the one you want to stand out.
  • Club builder. The interactive “build your case” page for a wine club. See Wine club below.
  • Image with text. An image beside a heading, text and button, with the image on either side.
  • Rich text. Eyebrow, heading, text and button blocks in any order.
  • FAQ. Questions and answers in expanding rows; optionally open the first one.
  • Newsletter. A sign-up form connected to Shopify customer marketing.
  • Contact form. Name, email, phone and message, sent to your store’s email address.
  • Custom Liquid. For your own Liquid or HTML.
  • Apps. A place for app blocks from apps that support them.

Buttons with no link set appear dimmed in the editor and can’t be clicked, so it’s easy to spot any you still need to fill in.

Wine club

Cellar includes a club landing section (Club tiers) and a full builder page (Club builder) where members choose a tier, a mix and a delivery frequency, confirm their age and join.

  1. Create one product for your club, for example “Wine Club Membership”, with a variant for each tier (such as 3 bottles, 6 bottles and 12 bottles) priced per shipment.
  2. To charge on a schedule, install a subscription app that supports Shopify selling plans and add the product to a subscription plan. Cellar shows its delivery frequencies automatically. Without one, the club works as a one-time purchase.
  3. Create a page called “Club”, set its template to page.club and open it in the theme editor.
  4. In Club builder, choose your club product and a collection whose bottles fill the case preview.
  5. Add a Tier block for each variant. The Variant name must match the variant’s title exactly. Tick Highlight on the tier you recommend; the builder starts on it.
  6. Edit the mix choices, minimum age, ZIP field and fine print to suit your club.

The mix, ZIP code and date of birth are added to the order as line-item properties, so you can see them on every order. The builder checks the date of birth against your minimum age before adding to cart.

Important: the club builder’s birthday check and the age gate are a courtesy confirmation, not legal age verification. Selling and shipping alcohol is regulated, and the rules vary by country, state and carrier. Use an age-verification or compliance app and an adult-signature shipping service where your laws require them.

Age gate

Turn the age gate on in the Age gate section (at the bottom of the section list on any page). Shoppers must confirm their age before browsing; their answer is remembered on that device. You can change the logo, heading, wording, button labels and the page shown to anyone who says no, or send them to another address.

The age gate stays hidden in the theme editor so it doesn’t get in your way. Tick Preview in editor to style it.

Fill the Case cart

Cellar’s cart opens as a drawer showing a wine case that fills slot by slot, with a message counting down to a full case. Under Theme settings → Cart & case:

  • Cart type: the Fill the Case drawer, or a classic cart page.
  • Bottles per case: 6 to 12.
  • Full case reward text: the reward the countdown promises, such as “10% off and free shipping”.
  • Enable gift note: adds a note field to the cart.

What fills the case: every product except gift cards. For anything else that isn’t a bottle, such as glasses, tasting tickets or a club membership, add the tag not-a-bottle in Shopify admin. Those products skip the case and the bottle count, and their button reads “Add to cart” instead of “Add to case”.

Remember: the reward text is only a message. Create the matching automatic discount or free-shipping rate in Shopify admin under Discounts or Shipping and delivery.

Customer accounts and taste profile

The Taste profile section on the account page averages the body and sweetness of every wine a customer has ordered, places a glass on a Flavor Map to show their style, and lists their recent bottles as a cellar log. Link its “Explore your style” button to a collection that has the Flavor Map turned on.

The taste profile works with Shopify’s classic customer accounts. Shopify’s newer customer accounts use pages that themes can’t change, so the profile won’t appear there.

Theme settings at a glance

GroupWhat you can change
LogoBanner logo, compact mark, footer logo, banner or inline style
ColorsFour color schemes: background (solid or gradient), card surface, text, muted text, accent, buttons and borders
TypographyHeading and body fonts, heading size and body size
Glass & motionPredictive search, frosted glass blur, button and card corners, slide-in animations
Cart & caseCart type, bottles per case, reward text, gift note
Product cardsRegion or vendor line, add-to-case button, bottle image frame
Social mediaInstagram, Facebook, TikTok, YouTube and Pinterest links
Favicon32 × 32 px browser icon

Every section also supports Shopify’s Custom CSS. Section CSS only affects that section; for site-wide changes use Custom CSS in Theme settings.

Accessibility and performance

Cellar is built with keyboard navigation, visible focus, screen-reader announcements when the cart or Flavor Map changes, and reduced motion for visitors who ask for it. It has no external libraries: one small script and one stylesheet, with images lazy-loaded and sized for each screen.

Updates

When a new version is released, Shopify shows an update notice in your theme library. Updating creates a new copy of the theme with your settings carried over; customizations made by editing theme code aren’t carried over, so note them first.

Version 1.0.0 (2026): first release.

Need help? Visit Cellar support or email mark@dexiderstudios.com.

Ask Dex