Overview
Wrapt is a Shopify theme for shops whose products are given as gifts: candles, home fragrance, stationery, small homeware, beauty and tea. Every product is shown in a gift box the shopper can open.
- Getting started — install, the demo content, the five settings to change first
- Sections — every section and block, what it does and what it needs
- Product data — the metafields the gift box reads, and how to fill them in bulk
- FAQ
- Support — how to reach us and what support covers
- Accessibility and motion
Getting started
- Add the theme from the Theme Store and choose Customize.
- Theme settings › Gift box: name your box papers (up to five) and pick their colours. Set the mark printed on the lid and tape (your shop name by default) and the line on the tape.
- Theme settings › Typography: the heading and body fonts come from Shopify's font library. Wrapt is designed around a soft serif for headings and a clean sans for body text.
- Theme settings › Colours: four colour schemes (Lining, Linen, Paper, Night). Each section picks one.
- Home page › Unboxing hero: pick the product that sits in the box. Its packshot, name, sizes and price fill the box, the band and the gift tag automatically.
- Navigation: a main-menu for the header, a menu of collections for the shelf tabs (the demo calls it shop), and footer / help menus for the footer.
- Products: give each product a packshot as its first image — a cut-out on a transparent or plain background looks best standing in the box; a photo is printed on a card in the box instead (set Image is a photo).
Demo content
The demo store (Ottoline, candles and home fragrance) uses nine products, six collections, three pages and four menus. The metafield definitions it uses are listed in Product data.
Sections
Unboxing hero (ks-unbox)
The signature section. The chosen product sits in a closed box — tape, wax seal, lid with its name and price on the band — beside the heading, a handwritten line and two buttons. Unbox it (or the scroll, or the paper pull-tab on the box) plays the unboxing: the seal is slit, the lid lifts, the tissue unfolds with the shopper's note in ink, and the product rises. Scrolling back closes it again.
- Product: any product. Sizes become tags under the box; the gift tag adds the chosen size to the bag with the box paper and the note.
- Step captions (4 blocks): they follow the four moves in order — seal, lid, tissue, product. Use
[product],[paper]and[notes]in the text. The second step has an optional phone title/text, because phones show the lid and tissue steps together. - With reduce motion on (or Motion turned off in Theme settings) the box opens and closes without movement.
Shelf of parcels (ks-parcels)
A collection as parcels on a shelf; each lid lifts as it scrolls into view. Each parcel has Add to bag and Put in gift box. The button label can use [count] (number of products in the store).
How it's wrapped (ks-wrapping)
A picture that a tissue sheet slides off, and up to five numbered steps (blocks). Link name lets a menu link to /#wrapping.
Scents and an evening (ks-scents)
Up to four product cards (blocks), each with its own picture (defaults to the product's second image), scent notes, a Gift box button that re-tints the gift box in that product's paper, and an evening scene with a quote and button.
Say it in ink (ks-note)
A note field the shopper types into while the note is written by hand on a cotton card (desktop) or a card right above the field (phones). Idea chips are blocks. The note is kept on the device and goes into the bag with every product as the line item property Note.
Questions (ks-faq), Featured product, Custom Liquid
Collapsible questions; one product in its open box beside a buy form (supports app blocks); your own Liquid.
Shelf (collection page)
The heading beside a stack of closed boxes, a row of category tabs from a menu (with counts), every storefront filter and the sort order as small popovers (one Filter & sort sheet on phones), removable filter chips, parcels, and a gift suggestion at the end. Filters come from the Search & Discovery app.
Product in its box (product page)
The product stands in its open box. Blocks: title, vendor, price (with unit price and tax line), description, scent notes, variant picker (sizes as layers; several options as pills with swatches), box paper, note in ink, quantity, stock status, buy buttons (selling plans, dynamic checkout, Shop Pay Installments, Put it in your gift box), pickup availability, collapsible tabs (text, a page, or What's in the box), text, custom Liquid, share and app blocks. On phones a buy bar appears only while the form's own button is out of view.
Goes well with
Shopify's product recommendations (related or complementary), with a fallback collection.
Header, footer, bag
Header: logo or your shop name in script, menu with dropdowns, search with suggestions, account (Shopify customer accounts), the gift box card, the bag. Footer: newsletter, Follow on Shop, three menus, country/language, payment icons. The bag opens as a drawer (or a page) with each line in its paper, its note, Change (size and paper) and Remove.
Product data
| Metafield | Type | What it does |
|---|---|---|
gift.paper | single line text | Name of a paper from Theme settings › Gift box (e.g. Pistachio). The product's box is wrapped in it. |
gift.default_variant | single line text | The variant shown first (e.g. Classic 220 g). |
gift.variant_details | JSON | A short line under each variant, e.g. {"Petite 90 g": "25 hours"}. |
gift.in_the_box | list of single line text | Lines for the What's in the box tab. |
gift.photo | true or false | The first image is a photo (printed on a card in the box) rather than a cut-out. |
notes.top, notes.heart, notes.base | single line text | Scent notes on cards, the hero and the product page. |
Create the definitions under Settings › Custom data › Products, then fill them per product or in bulk with the bulk editor. Everything works without them: the box uses the first paper, the first available variant, and the product description.
FAQ
My product looks too small / too large in the box. The box fits the packshot's proportions. Use an image with little empty space around the product; tall bottles and wide sets are scaled to fit.
My packshot has a background. Set Image is a photo (gift.photo) — the photo is printed on a card in the box. Or remove the background (Shopify's image editor can do it) for a product that stands in the box.
Can I turn the unboxing off? Theme settings › Motion and ink › Motion. The box then opens and closes without movement. Shoppers who ask their device to reduce motion always get the still version.
Where does the gift note go? Into the bag as the line item property Note on every product, and onto the order.
Can shoppers order without a note or a box paper? Yes. Both are optional.
Do I need an app for filters? Shopify's Search & Discovery app (free) decides which filters show on the shelf.
Does the theme support subscriptions, pickup and Shop Pay Installments? Yes — selling plans appear on the product page when a subscription app adds them; pickup availability and the installments banner show automatically.
How do I translate the theme? Online Store › Themes › Edit default theme content.
Accessibility and motion
- Every control is a real button or link, reachable by keyboard, with a visible focus ring and a label.
- Popovers and sheets close with Esc and return focus; dialogs use the native
<dialog>element. - Text meets WCAG AA contrast in every colour scheme; no text is muted below that.
- The unboxing, parcel lids and tissue reveals are scrubbed by scroll in both directions and never move the page by themselves. With reduce motion nothing moves: the box opens and closes with a button.
- Handwritten notes are drawn on a canvas and also given as plain text to screen readers.
Support policy
- How to reach us: https://portfolio.aivcj.com/support (FAQ, contact form and email). The same link is on the Theme Store listing and in the theme editor under Theme settings → Theme info.
- Reply time: we reply within 2 business days (Monday to Friday).
- Cost: support is free, with no charge, for every merchant who bought the theme.
- What it covers: installing and setting up the theme, its settings, sections and blocks, bugs in the theme's code, and questions about this documentation.
- What it doesn't cover: changes you or a developer made to the theme's code, third-party apps, and custom design work.
- Updates: fixes and improvements are released as theme updates; see the changelog.