Glossary

This page lists terms where the store, the code and the Shopify UI use different names, or where a general word has a narrow meaning here.

Entrypoint

A file directly under src/entrypoints/. Vite compiles each one into its own bundle that Liquid can load by name. Files in src/components/ and src/lib/ are imported by entrypoints and never loaded on their own. See How the build works.

vite-tag

snippets/vite-tag.liquid, a generated lookup table mapping entrypoint paths to hashed asset filenames. Vite rewrites it on every build. Never edit it.

Mini-cart

The cart drawer, and the set of custom elements that build it. Distinct from cart-drawer, an older implementation that still exists in sections/ and renders nowhere. See Mini-cart.

Reward tier

A cart subtotal threshold that unlocks a free gift. Four are supported, configured in Theme settings under Rewards Tiers. The tier supplies the threshold and the copy. The minicart_free_gifts metaobject supplies the product.

Also called a free gift tier, a bonus tier or a reward level, depending on who is speaking.

Free gift

A cart line carrying the __free_gift property. The cart excludes it from the reward subtotal, so a gift cannot unlock a further gift.

Cart source

The _source line item property, recording which part of the storefront added a line, in the form surface:function. Shopify hides properties starting with an underscore from the storefront and checkout, so it stays out of customer-facing output while remaining visible in /cart.js, the order in Shopify Admin and webhooks.

Line item key

Shopify's identifier for a cart line, derived from a hash of the line's properties. Writing a property creates a new key for the same line, which is why cart writes are serialised and why stale keys need recovery. See Mini-cart.

MediSpa

The clinic treatment side of the business. Written MediSpa in customer-facing copy, medispa in code, file names, vendor names and CSS classes. The theme detects a MediSpa page from the template-medispa-v2 or medispa-lp body class, or from a product vendor name containing medispa.

Clinic

A physical MediSpa location. Each clinic is an entry in the medispa_locations metaobject and appears as a tab in the booking calendar. Older code sometimes calls it a location or a store.

Deposit

The partial payment taken at booking, implemented as a Downpay selling plan on the treatment product. The remainder is the balance owing, shown on the cart line as the Remaining Amount property.

Pay in clinic

The alternative to a deposit. The customer books without paying and settles the full amount at the appointment. custom.enable_pay_in_store on the product controls it, and a page-level custom.pay_in_store metafield can override it.

Written as Pay In Clinic in customer-facing copy and pay_in_store in code and metafield names.

Reservation token

The value Sesami returns when a slot is held, stored on the cart line as _reservation_token. A booking line without one is a treatment purchase with no appointment attached.

Popup manager

The theme code that decides which popup may open and when. It does not create popups. Klaviyo and the theme's own popup definitions create those. See Popups and forms.

Sniffer

A component that watches the page for popups appearing, so the popup manager can take control of something it did not create. There is one for Klaviyo and one for theme popups.

Yett

The library that holds back third-party scripts until the theme releases them. Each layout sets window.YETT_BLACKLIST, and snippets/yett-unblock.liquid releases everything on the first touch, keypress or click.

Theme editor

Shopify's visual editor, reached from Online Store, Themes, Customize. It writes directly to the theme being edited, including the live theme. Sometimes called the customizer.

Theme settings

The global settings in the theme editor's sidebar. The schema is in config/settings_schema.json and the saved values are in config/settings_data.json. Distinct from section settings, which live in the section's own schema and in the JSON template.

Metaobject

Shopify's structured content type, edited under Content, Metaobjects in Shopify Admin. This theme uses medispa_locations for clinics and minicart_free_gifts for free gifts.

JSON template

A template in templates/ with a .json extension, editable in the theme editor. A Liquid template, by contrast, is fixed markup and needs a commit to change.

Section group

A JSON file in sections/ defining a group of sections, used for headers and footers. Merchandisers edit it in the theme editor like a template.

Alternate template

A template with a suffix, such as product.gift-card-pro.liquid, assigned to individual products or pages in Shopify Admin under Theme template. This store has many of them, so a change to the default template may not reach every page of that type.

theme-pull

The GitHub Action at .github/workflows/theme-pull.yml that copies theme editor changes from the live theme into the production branch. See Branches and theme sync.

Preview theme

An unpublished theme created for review or device testing. The preview helper creates a new one on every run and never reuses one. Distinct from the development theme that shopify theme dev creates.

Store handle

a-sales-affair. It does not match the brand name, and every Shopify CLI command targets it. The public domain is beautyaffairs.com.au.