Shippo documentation

shippo docs

Everything in the theme, written down: how to install it, how to set up your store and checkout, every section with its settings and blocks, the theme settings, the templates, the limits and the changelog. Read it before you buy or keep it open while you build.

Theme version 0.1.0Updated 29 October 202632 sections documentedChecked against the theme files on every build

Shippo, EUR 149 Open the demo store (opens in a new tab)Design demo (opens in a new tab)

The demo store asks for a password: bairte. Prices there are shown in USD.

Quick start

You get a ZIP with the theme, a license key for one store, this guide as a file, a style kit and three sample products. Nothing is public until you click Publish.

In your Shopify admin open Online Store, then Themes.
Click Add theme, then Upload zip file, and choose shippo-theme.zip from the package (the inner ZIP).
When the upload finishes, click Customize to open the theme editor.
In the editor open Theme settings, License, and paste the license key from your purchase page.
Optional: in Products, Import, upload demo-data/products.csv to see the theme with content. The sample products import as drafts, so customers never see them. Best done in a development store or a store that is not open yet.

The sample matcha products and their photos are demo content and are not part of the license. Replace every photo and text with your own before you publish the store. The style kit in the package has an image prompt for every photo slot.

Set up your store

Sections. Content, images, colors and layout settings are edited in the theme editor. Add, remove and reorder sections on each page. On the product page the title, price and buy button keep a fixed place; app blocks can be added between the other blocks.
Colors and fonts. Theme settings, Colors and Layout. Fonts are hosted inside the theme, so the storefront makes no Google Fonts requests.
Logo. The round badge in the top left corner of the header is the link to your home page. Keep the text mark or upload a round logo in the Header settings. The style kit, part 3, has a ready prompt for making one.
Menus. The header shows your Shopify navigation; sub-menus open on hover and tap. Footer columns take their own menus in the Footer settings.
Bundle cards. On the product page, a product option named as you set it in the Product section (for example Single, Duo, Trio) is shown as cards with the price and the saving. They are variants of one product, priced and stocked in Shopify. The theme does not combine separate products or share one stock pool between the sets.
Cart add-on. In the Cart drawer section choose an add-on product, for example a gift note. With the message field on, the customer’s text is saved on the order line as a property called Note.
Contact page. In Pages, open your contact page and choose the template page.contact. It shows a form that sends mail to your store email; any text you write in the page appears above the form.
Several currencies. Use Shopify Markets and set a fixed price per market on each variant. The theme shows whatever price Shopify gives it and converts nothing itself.
Before you publish. The founder’s letter, FAQ answers, shipping and return promises, product texts and photos describe the demo brand. Check every text and keep only the promises you can keep.

Checkout and thank-you page

The checkout and the thank-you page are not part of any theme. Shopify keeps them separate, so set them once in your admin so the last step of the purchase looks like your store. Open Settings, Checkout, then Customize. The editor has two panels: the section list (first icon) and Settings (the gear icon).

Logo: in the section list open Header, then Logo, and upload your logo. The round header badge works well.
Settings, Main section: Background #FFFBEF.
Settings, Header: Background #FFFBEF, Accent #2F5A22 (links and the cart icon).
Settings, Accent and buttons: Accent #2F5A22, Button #2F5A22.
Section list, Order summary: Background #F1EFEA, Accent #2F5A22. This is the right-hand column with the products and the total.
Settings, Typography: a clean sans-serif for headings and body. If Funnel Sans is offered, use it, because it is the body font of the theme.
Click Save.

Use your own values from Theme settings, Colors if you changed the palette. The thank-you page uses the same colors and logo. To add your own words there, change the order confirmation email in Settings, Notifications. Extra blocks on the thank-you page need an app; deeper changes to the checkout layout need Shopify Plus or an app. Check the result with a test order.

Sections, one by one

32 sections, read straight from the theme files. Each entry lists where the section is used, what it does, and every setting and block with the note you see in the editor. Screenshots of each section are being added; for now, open the demo store to see them live.

Header and footer

On every page. Edited once, in the header and footer groups of the theme editor.

Header

Header group, every page

The round logo badge, the menu and the cart button. Sub-menus from your Shopify navigation open on hover and tap. It sits in the header group.

Settings 4

Setting	Kind	Note
Menu	Menu
Logo (round, shown at 56 px)	Image
Text mark when there is no logo	Text
Show language switcher	On or off	Appears when the store has more than one language.

Announcement bar

Header group, every pageIn the section picker

A slim strip at the very top of every page. One message, or several that rotate, with a visible pause button.

Settings 3

Setting	Kind	Note
Text	Text
Extra text (hidden on phones)	Text
Accessible label	Text	Used when you add several messages below.

Block: Rotating message 1

Setting	Kind	Note
Text	Text

Footer

Footer group, every pageIn the section picker

A big brand word, an email sign-up, an about text, three menu columns and the small print. The footer colors and gradient are set here.

Settings 22

Setting	Kind	Note
Big word	Text
Round mark next to the word	Text
Show email sign-up	On or off
Sign-up text	Formatted text
About text	Formatted text
Colors
Background	Choice: Soft gradient with grain, Solid color (uses Bottom color)
Top color	Color
Middle color	Color
Bottom color	Color
Text and links	Color
Big word	Color
Sign-up text (top right)	Color
Columns
Column 1 title	Text
Column 1 menu	Menu
Column 2 title	Text
Column 2 menu	Menu
Column 3 title	Text
Column 3 extra links	Menu
Small print
Line 1	Text, several lines
Line 2	Text, several lines
Line 3	Text, several lines
Show 'Designed by Kamiwaza Studio'	On or off

Cart drawer

Footer group, every page

The slide-in cart: an optional free-shipping bar, an add-on with a switch (for example a gift note) and product suggestions. It sits in the footer group, so it is on every page.

Settings 11

Setting	Kind	Note
Free shipping bar
Free shipping from (store currency)	Slider, 0 to 1000	0 hides the bar. Set it in your store currency. Only use it if your shipping settings really offer free shipping from this amount. The bar is hidden for customers who pay in another currency.
Add-on with a switch
Add-on product	Product	Shown as a switch in the cart, for example a gift note, a care plan or extended support. Leave empty to hide.
Add-on title	Text
Add-on text	Text
Ask for a message once the add-on is on	On or off	Shows a text field that is saved on the cart line as a property called Note, so it appears on the order.
Message field label	Text
Message field hint	Text
Upsell
Suggest more products in the cart	On or off
Heading	Text
Products to suggest	Collection	Leave empty to use all products. Items already in the cart are skipped.
How many to suggest	Slider, 1 to 4

Home page and storytelling

Add these from the section picker on the home page, on product pages and on any page template. Reorder them by dragging.

Hero, two photos

Home pageIn the section picker

Two large photos side by side, a small line above the heading, the heading and a button. The right photo is hidden on phones.

Settings 6

Setting	Kind	Note
Left photo	Image
Right photo	Image	Hidden on phones.
Small line above the heading	Text
Heading	Text with bold and links
Button label	Text
Button link	Link

Ticker

Home pageProduct page, story templateIn the section picker

A scrolling strip of short phrases, with a pause button.

Settings 2

Setting	Kind	Note
Accessible label	Text
Seconds per loop	Slider, 10 to 80

Block: Item 1

Setting	Kind	Note
Text	Text

Brand statement

Home pageIn the section picker

A short, quiet block of text with vertical captions at both page edges. One promise, or a mood.

Settings 6

Setting	Kind	Note
Heading	Text with bold and links
Text	Formatted text
Vertical captions at the page edges
Left caption	Text
Left caption, small Latin line	Text
Right caption	Text
Right caption, small Latin line	Text

Product cards

Home pageIn the section picker

Cards for your products or sets, up to six, in two styles: a product on a light card, or a full photo with a note and a buy button.

Settings 1

Setting	Kind	Note
Anchor name	Text	Optional. Lets a button jump straight to this section: name it shop and link the button to #shop. Use each name only once per page.

Block: Card, up to 6 per section 9

Setting	Kind	Note
Style	Choice: Product on a light card, Full photo with a buy button
Product	Product
Image	Image	Leave empty to use the product's first image.
Big word on the card	Text
Tag (product style)	Text
Title (product style)	Text	Leave empty to use the product title.
Short description (product style)	Text
Note over the photo (photo style)	Formatted text
Button label (photo style)	Text	Use [price] to insert the product price.

Coming soon

Home pageIn the section picker

A teaser for the next product, with an optional email sign-up. Without an image it becomes a secret teaser with blacked-out lines.

Settings 11

Setting	Kind	Note
Image	Image	Shown on the left, or on the right when flipped. On phones it sits above the text. Leave empty for a secret teaser: centered text with hidden-line bars and no picture.
Put the image on the right	On or off
Background	Choice: Plain (page color), Soft panel, Dark green
Text
Small label	Text
Heading	Text with bold and links
Show hidden-line bars	On or off	Bars under the heading that look like blacked-out text. Always shown when there is no image.
Text	Formatted text
Release date line	Text	Optional, for example: Planned for spring. Leave empty to hide.
Email sign-up
Show email sign-up	On or off	Uses the Shopify customer form and adds the tag newsletter. No app needed.
Button
Button label	Text	Optional. Needs a link as well.
Button link	Link

Trust bar

Home pageProduct pageIn the section picker

Up to four short promises with icons, for example shipping, returns or a gift box.

Block: Item, up to 4 per section 3

Setting	Kind	Note
Icon	Choice: Truck, Refresh, Gift box, Card, Leaf, Heart, Shield
Title	Text
Text	Text

Founder's letter

Home pageProduct page, story templateIn the section picker

A heading and a personal letter with a signature, next to a collage of three photos.

Settings 10

Setting	Kind	Note
Heading	Text with bold and links
Letter	Formatted text
Signature	Text
Role under the signature	Text
Photo 1 (wide, top left)	Image
Photo 2 (tall, right)	Image
Photo 3 (wide, bottom left)	Image
Vertical caption at the page edge
Caption	Text
Small Latin line	Text
Advanced
Anchor name	Text	Optional. Lets a button jump straight to this section: name it shop and link the button to #shop. Use each name only once per page.

Image with text

Home pageProduct pageProduct page, story templateIn the section picker

Rows of image and text that alternate sides. Each row has a small label, a heading, a text and an optional button.

Settings 1

Setting	Kind	Note
First row image	Choice: Left (then alternate), Right (then alternate)	Rows alternate by default. A row can override this in its own settings.

Block: Row 7

Setting	Kind	Note
Image	Image
Image side	Choice: Automatic (alternate), Left, Right
Small label	Text
Heading	Text with bold and links
Text	Formatted text
Button label	Text
Button link	Link

What's in the box

Home pageProduct pageProduct page, story templateIn the section picker

What the customer gets: one item per block, each with a photo, a title and a short description.

Settings 5

Setting	Kind	Note
Heading	Text
Intro	Text with bold and links
Vertical caption
Caption	Text
Small Latin line	Text
Advanced
Anchor name	Text	Optional. Lets a button jump straight to this section: name it shop and link the button to #shop. Use each name only once per page.

Block: Item 3

Setting	Kind	Note
Image	Image
Title	Text
Description	Text, several lines

Ways to use your product

Home pageProduct page, story templateIn the section picker

Three ways to use the product, each with a photo, a small label, a title and a short text.

Settings 4

Setting	Kind	Note
Heading	Text
Vertical caption
Caption	Text
Small Latin line	Text
Advanced
Anchor name	Text	Optional. Lets a button jump straight to this section: name it shop and link the button to #shop. Use each name only once per page.

Block: Way to use 4

Setting	Kind	Note
Image (3:4)	Image
Small label	Text
Title	Text
Text	Text, several lines

Photo carousel

Home pageProduct page, story templateIn the section picker

A row of square photos that scrolls sideways, with a heading and a button that defaults to your Instagram link.

Settings 3

Setting	Kind	Note
Heading	Text
Button label	Text
Button link	Link	Leave empty to use the Instagram link from Theme settings.

Block: Photo 1

Setting	Kind	Note
Photo (square)	Image

Comparison table

Home pageIn the section picker

Your product next to alternatives, column by column, with a highlighted column and a badge. Rows are typed once, answers once per column.

Settings 3

Setting	Kind	Note
Heading	Text
Intro	Text with bold and links
Rows (one per line)	Text, several lines	Each column below needs one answer per row, in the same order.

Block: Column, up to 4 per section 5

Setting	Kind	Note
Title	Text
Subtitle	Text
Badge	Text
Highlight this column	On or off
Answers (one per row)	Text, several lines	Write yes or no, or any short text.

FAQ

Home pageProduct pageProduct page, story templateIn the section picker

Questions and answers that open and close. Add as many as you need.

Settings 4

Setting	Kind	Note
Heading	Text
Vertical caption
Caption	Text
Small Latin line	Text
Advanced
Anchor name	Text	Optional. Lets a button jump straight to this section: name it shop and link the button to #shop. Use each name only once per page.

Block: Question 2

Setting	Kind	Note
Question	Text
Answer	Formatted text

Customer videos

Home pageProduct page, story templateIn the section picker

Short self-hosted clips from customers’ own posts, each linking to the original. Up to eight.

Settings 3

Setting	Kind	Note
Short clips from your customers' own posts. Each card plays a small self-hosted clip and opens the original post in a new tab. We use no third-party embeds or iframes on purpose: they load tracking scripts, slow the page down and need extra privacy consent. Ask each creator for permission before you feature their post.
Heading	Text
Small caption	Text	Optional line under the heading.
Visible note	Text	Shown under the videos only when filled. Clear it for real customer content.

Block: Video, up to 8 per section 5

Setting	Kind	Note
Clip (mp4)	Video (mp4)	Upload to Files first. About 4 seconds, 9:16, under 3 MB, no sound.
Cover image	Image	Shown before play, with reduced motion, or when no clip is set.
Link to original post	Link
Platform	Choice: Instagram, TikTok, YouTube, X, Other
Creator handle	Text	For example @name.

Customer quotes

Product page, story templateIn the section picker

Quotes you have permission to show, with a name, a detail and an optional photo.

Settings 1

Setting	Kind	Note
Heading	Text

Block: Quote 4

Setting	Kind	Note
Quote	Text, several lines	Only use real words from real customers.
Name	Text
Detail (city, product bought)	Text
Photo (optional)	Image

Before and after

In the section picker

Two photos under a slider, with labels and a note. Use it only where the comparison is accurate and allowed for your product.

Settings 7

Setting	Kind	Note
Heading	Text
Text	Text with bold and links
Before image	Image
After image	Image	Use the same size and framing as the before image.
Before label	Text
After label	Text
Note under the slider	Text	For example: results vary, photos are unretouched.

Columns

In the section picker

Two to four columns, each with an image, a title, a text and a link. Good for benefits or steps.

Settings 2

Setting	Kind	Note
Heading	Text
Columns on desktop	Choice: 2, 3, 4

Block: Column 5

Setting	Kind	Note
Image	Image
Title	Text
Text	Text, several lines
Link label	Text
Link	Link

Rich text

In the section picker

A small label, a heading, a text and a button, left or centered. The simplest building block.

Settings 6

Setting	Kind	Note
Alignment	Choice: Left, Center
Small label	Text
Heading	Text with bold and links
Text	Formatted text
Button label	Text
Button link	Link

Related products

Product pageProduct page, story templateIn the section picker

Suggestions at the bottom of the product page, picked by Shopify or by your Search & Discovery settings.

Settings 3

Setting	Kind	Note
Heading	Text
Show	Choice: Related products, Complementary (Search & Discovery)
Number of products	Slider, 2 to 8

Product page

The main section of the product templates. Its blocks are the column next to the gallery.

Product

Product pageProduct page, story template

The product page: gallery, title, price, bundle cards, buy buttons and a column of blocks you can reorder in the editor. A sticky add-to-cart bar follows the customer while scrolling.

Settings 6

Setting	Kind	Note
Sticky add to cart bar while scrolling	On or off
Bundle and save
Show the bundle option as cards	On or off	Turn off to show it as plain buttons. The cards show the prices and compare-at prices you set on your variants.
Name of the option to show as bundle cards	Text	A product option named like this (for example Single, Duo, Trio) is shown as cards with the price and the saving.
Bundle title	Text
Value that gets a badge	Text
Badge text	Text

Block: Title, one per section 1

Setting	Kind	Note
Show vendor above the title	On or off

Block: Price, one per section 0

No settings. Add or remove the block to show or hide it.

Block: Short summary, one per section 1

Setting	Kind	Note
Length in characters	Slider, 60 to 300	First words of the product description, without formatting.

Block: Buy buttons, one per section 0

No settings. Add or remove the block to show or hide it.

Block: Secure checkout, one per section 3

Setting	Kind	Note
Text	Text
Show payment method icons	On or off	Shows the payment methods you have enabled in Shopify.
Show example icons when none are set up yet	On or off	For demos only. Turn off when your payments are live.

Block: Short promise 2

Setting	Kind	Note
Icon	Choice: Truck, Refresh, Gift box, Card, Leaf, Heart, Shield
Text	Text

Block: Product description, one per section 2

Setting	Kind	Note
Title	Text
Open by default	On or off

Block: Accordion 3

Setting	Kind	Note
Title	Text
Text	Formatted text	Leave the text empty to hide this block on the live store.
Open by default	On or off

App blocks

Shopify apps that offer theme app blocks can be added between the other blocks of this section.

Other page templates

One main section per template. Most have no settings; their texts come from Shopify and from the theme translations.

Collection

The product grid of a collection, with a setting for products per page.

Settings 1

Setting	Kind	Note
Products per page	Slider, 6 to 24

Collection list

A list of all your collections.

No settings.

Page

A plain page with the text from the Shopify page editor.

No settings.

Contact page

A contact form that sends mail to your store email. Any text written in the Shopify page itself appears above the form.

Settings 1

Setting	Kind	Note
Intro line	Text

Cart

Cart page

The full cart page, used when the slide-in cart is not available, for example with JavaScript off.

No settings.

Search

Search results.

No settings.

Page not found

The page shown when a link is broken. No settings; the text comes from the theme translations.

No settings.

Password page

The password page for a store that is not open yet.

No settings.

Theme settings

Store-wide settings in the theme editor, under Theme settings.

Colors

Setting	Kind	Note
Background	Color
Cards and panels	Color
Text	Color
Secondary text	Color
Muted text	Color
Accent	Color
Accent, lighter	Color
Product labels and prices	Color

Layout

Setting	Kind	Note
Page width	Slider, 1000 to 1600 px
Corner radius of large panels	Slider, 0 to 40 px
Fade sections in while scrolling	On or off

Social media

Setting	Kind	Note
Instagram link	Link
TikTok link	Link
Pinterest link	Link
YouTube link	Link

Cart

Setting	Kind	Note
Show the order note field on the cart page	On or off

License

Setting	Kind	Note
Paste the license key from your purchase email. It is needed for updates and support, and it is never shown to your customers.
License key	Text

Templates

Which sections each page template contains out of the box. You can add, remove and reorder them in the editor; the product page comes in two versions, a short one and a long story version you can assign to a product.

Template	Sections, in order
Page not found	Page not found
Cart page	Cart
Collection	Collection
Home page	Hero, two photos · Ticker · Brand statement · Product cards · Coming soon · Trust bar · Founder's letter · Image with text · What's in the box · Ways to use your product · Photo carousel · Comparison table · FAQ · Customer videos
Collection list	Collection list
Contact page	Contact page
Page	Page
Password page	Password page
Product page	Product · Trust bar · Image with text · What's in the box · FAQ · Related products
Product page, story template (long version)	Product · Ticker · Image with text · What's in the box · Ways to use your product · Photo carousel · Founder's letter · Customer quotes · Customer videos · FAQ · Related products
Search	Search

Good to know and limits

Built for one product or a small range. Catalog navigation is basic: a collection grid, a collection list and search.
The variant picker handles products with up to 250 variants. Selling plans (subscriptions) are not supported.
Bundle cards are variants of one product. The theme does not combine separate products.
Sub-menus show one level below the main menu.
Social links in Theme settings need a full address starting with https://.
The slide-in cart and the product form need JavaScript. Without it, customers use the cart page and a plain variant list.
No third-party JavaScript libraries and no external font requests in the storefront code.
Products with complex options or custom product apps: check them on a duplicate theme first, or write before buying.

Updates

Feature updates are included for 12 months after purchase. Each update is a new theme ZIP with a changelog. Bug fixes for the version you bought are not time-limited. Installing a new ZIP does not move your settings, so update like this:

Upload the new ZIP as a new theme. Do not publish it yet.
On both themes open Actions, then Edit code.
Copy the contents of config/settings_data.json and the files in templates/ from your old theme into the same files of the new theme. If the changelog says the new version adds settings, add only your own values and keep the new keys.
Preview the new theme, then publish it. Keep the old theme as a backup for a few days.

Your theme settings live in config/settings_data.json; the content of every page (sections, texts, images, order) lives in templates/*.json.

Changelog

0.1.0, 27 October 2026. First public version.
- Cart drawer: every quantity change goes through one queue, the controls lock while a request is in flight, the Check out button waits until an unsaved gift note is stored, and a failed request no longer leaves the buttons disabled.
- Product form works with JavaScript off (plain variant list and cart page); the mobile menu is visible without JavaScript.
- Product titles, option names, menu labels and JSON in script tags are escaped; social links accept only http and https.
- Cart drawer is a real dialog: focus stays inside, the page behind is inert, Escape closes it.
- Ticker, customer videos and the rotating announcement bar have a visible pause button; everything that moves respects the reduced-motion setting.
- Product cards show "From" when variants differ in price; choosing a variant scrolls the gallery to its photo; one H1 per page; section anchors stay unique when a section is used twice.
- Coming soon section with a secret mode (no image, blacked-out lines); customer videos section; contact page template with a form; "Designed by Kamiwaza Studio" line in the footer, with a switch.

Support and license

Support and updates: support@kamiwazastudio.com. Include your license key. We usually reply within one or two business days.
Support covers installation and reproducible theme bugs. Custom design work, store setup and third-party app configuration are quoted separately.
Shopify support sends third-party theme issues back to the developer, so write to us directly.
One license covers one Shopify store. You can move it between stores you own, one at a time. Read the license.

FAQ

Do I have to sell matcha?

No. The matcha set is only demo content so you can see the theme in a fully populated demo store. Replace it with your own products, images and copy. The layout is built around one product or a small range, so it suits a small catalog best. If your products have many variants, subscriptions or custom product apps, write to us before buying and we will tell you whether it fits.

Why choose Shippo instead of a free theme like Dawn?

Choose Shippo if you want a ready-made visual direction for one main product: large photography, product storytelling and a focused buying flow. Choose a broader theme if you need extensive catalogue navigation or many different store layouts.

Can I use the demo photos on my store?

Not on a live store. The sample products import with our demo photos so your store is not empty while you set it up, but the photos and videos are preview content and are not part of the license. Replace them with your own before you publish. The style kit in the package has image prompts for every photo slot.

Do I need apps?

No apps are required for the features shown here. The slide-in cart, bundle cards, sticky bar and the other features on this page are part of the theme itself. The product page has a block where Shopify apps can be added; some integrations, for example subscriptions or product personalisation, may need development.

How do the bundle cards handle inventory?

The Single, Duo and Trio cards are variants of one product, so each card has its own stock count in Shopify. A Duo sale lowers the Duo stock only; the Single stock stays as it was. The theme does not share one stock pool between the sets or combine separate products. If your sets must draw from one stock count, write to us before buying.

How do I install it?

In your Shopify admin go to Online Store > Themes > Add theme > Upload ZIP file and choose the Shippo ZIP from your download. The theme appears in your theme library, where you set it up and publish it when you are ready. The install guide in the package walks through this and the first settings, and the online documentation lists every section and setting. Installation questions go directly to me; Shopify support sends third-party theme issues back to the developer.

Does it work with subscriptions or products with many variants?

Subscriptions (selling plans) are not supported. Shippo supports products with up to 250 variants. If your product needs more variants or complex product options, write to us before buying.

How do updates work?

Feature updates are included for 12 months. Each update is a new theme ZIP with installation instructions. Your current theme keeps working after that period. Installing a new ZIP does not automatically transfer your store theme settings, so add the new version as a separate theme, compare it with your live one and publish it when you are happy. After the 12 months, new versions may be offered separately.

Who makes and supports Shippo?

Made and supported by Artur Kociuba. Kamiwaza Studio is my independent Shopify theme studio in Rzeszów, Poland. I design, build and support Shippo directly.

How are the themes made?

Every theme starts with an idea and a sketch on paper. Sometimes the vision comes straight from my head, sometimes I look at how other stores present their products and then design something of my own. I choose the layout, type, colors and sections, and I test each theme in a real Shopify store before it is sold. I use AI tools to write the code and to create the demo photos and videos. Demo store imagery is AI-generated and for preview only.

Can you set it up for me?

Yes, as an optional paid service that is quoted separately. Write to us with a short description of your store.