Tumble documentation

How to set up Tumble, choose a style, and use every setting and section. Written for shop owners, no code needed.

For version 0.4.0 · Styles: Tumble, Kettle, Linen

Install and choose a style

Tumble has three styles. Each has its own colors, fonts, card shapes and home page:

  • Tumble: playful sticker cards, made for pet supplies.
  • Kettle: serif headings and soft shadows, made for home and kitchen shops.
  • Linen: calm and minimal, made for lifestyle and fashion brands.
  1. Choose a style on Tumble's Shopify Theme Store page, then select Try theme or Buy theme.
  2. Tumble is added to Online Store, Themes in your Shopify admin.
  3. Select Customize to open the theme editor, add your logo and content, then Publish when you're ready.

To try a different style later, add Tumble again from the Theme Store with that style. Your current theme stays as it is.

Logo, colors and fonts

Open Theme settings in the theme editor.

  • Logo and favicon: upload your logo and set its width for desktop and mobile. Logos of any shape work.
  • Colors: Tumble has seven color schemes. Each section has a Color scheme setting, so changing a scheme updates every section that uses it. Badge colors are set here too.
  • Typography: pick fonts for headings and body text from Shopify's font library, and set sizes and letter spacing.
  • Shape and depth and Buttons: corner radius, border thickness, shadows and button shape.

Product pages

The Product information section is built from blocks you can reorder: badges, title, vendor, price, SKU, text, Variant picker and buy buttons, Inventory status, Service highlights, description, Collapsible tab and Custom Liquid. Apps can add their own blocks too.

  • Badges: sale and sold out badges are automatic. For your own badge, add a product tag like badge:New, and the text after the colon becomes the badge.
  • Inventory status uses your real Shopify inventory. Set Show "low stock" at or below to choose when the low stock message appears. Tumble never shows made-up stock counts.
  • Variant pictures: assign an image to each variant in the product admin and Tumble switches to it when a customer picks that option. If your options use Shopify's color swatches, the picker shows them.
  • Card feature points (optional): create a product metafield custom.card_points (list of single line text) to show short points on product cards when Show feature points is on.
  • Specifications (optional): create a product metafield custom.specifications (multi-line text, one "Name: value" per line) and choose it in a Collapsible tab.
  • Local pickup shows under the buy buttons when you offer pickup (Settings, Shipping and delivery). Shop Pay Installments appears when it's turned on in your payment settings.

Collections, filters and search

  • Filters come from Shopify's free Search & Discovery app. Install it and choose filters such as availability, price, product type, vendor and options. The Product grid section's Filters setting controls where they show.
  • The Product grid section also sets products per page, columns on desktop and mobile, and the collection banner.
  • Search suggests products as customers type. Turn this off with Show suggestions while typing in Theme settings, Search.

Cart

  • In Theme settings, Cart, When a product is added chooses between opening the cart drawer and going to the cart page.
  • Enable order notes lets customers leave a note. Message under the cart total is a good place for delivery or returns information.
  • Discounts, subscriptions and unit prices are shown automatically, and express checkout buttons appear on the cart and product pages when your payment settings allow them.

Selling in other countries and languages

When you sell in more than one market or language (Settings, Markets and Languages), the footer shows country and language selectors. Turn them off with Show country and language selectors in the Footer section.

Accessibility

Tumble works with a keyboard and screen readers, keeps focus visible, and every color pair in each style passes WCAG AA contrast. To keep your store accessible, add alt text to images, write clear link and button labels, and check contrast if you change colors.

Updating Tumble

When a new version is released, Shopify shows an update notice in your theme library. Updating adds a new copy of the theme with your settings and content. Code you changed yourself isn't carried over, so keep a note of any changes and redo them in the new copy.

Theme settings reference

In the theme editor, open Theme settings (the gear icon). Every setting is listed here with the help text you see in the editor.

Logo and favicon
  • Logo
  • Desktop logo width
  • Mobile logo width
  • Favicon Shown at 32 × 32px.
Colors
  • Color schemes
  • Badges
  • Sale badge
  • Sale badge text
  • Custom badge Custom badges come from product tags that start with "badge:", for example "badge:New in".
  • Custom badge text
  • Sold out badge
  • Sold out badge text
Typography
  • Headings
  • Heading size
  • Heading case Options: Default, Uppercase.
  • Heading letter spacing
  • Body
  • Body size
Layout
  • Page width Options: Narrow, Standard, Wide.
  • Side margin on mobile
  • Space between sections Halved on mobile.
  • Grid spacing
Shape and depth
  • Card corner radius
  • Border thickness
  • Shadow Options: None, Soft, Offset (sticker).
  • Offset shadow distance
Buttons
  • Shape Options: Pill, Rounded, Square.
  • Use the card shadow on buttons
  • Label case Options: Default, Uppercase.
Product cards
  • Card style Options: Sticker: border and shadow, Panel: filled, no border, Minimal: image and text only.
  • Image shape Options: Square, Portrait, Landscape, Match image.
  • Image fit Options: Fill, Fit.
  • Show second image on hover
  • Text above title Options: None, Vendor, Product type.
  • Show color swatches Uses the swatches set on product options in Shopify admin.
  • Show add to cart button Products with options link to the product page instead.
  • Text alignment Options: Left, Center.
  • Show savings on sale badge
Cart
  • When a product is added Options: Open cart drawer, Go to cart page.
  • Enable order notes
  • Message under the cart total For example your delivery promise. Leave blank to hide.
Search
  • Show suggestions while typing
Motion
  • Fade sections in on scroll Always off for visitors whose device asks for reduced motion.
  • Lift cards and buttons on hover
Social media
  • Instagram
  • Facebook
  • TikTok
  • YouTube
  • Pinterest

Sections reference

Sections you can add to any page with Add section:

Announcement bar
  • Style Options: Static, Scrolling.
  • Scrolling speed
  • Color scheme

Blocks

Message
  • Text
  • Link
Collection list
  • Heading
  • Image shape Options: Circle, Rounded square.
  • Columns on desktop
  • Swipe on mobile
  • Show product count
  • Color scheme

Blocks

Collection
  • Collection
  • Custom title
  • Custom image
Custom Liquid
  • Custom Liquid Add app snippets or other Liquid code to create advanced customizations.
  • Color scheme
FAQ
  • Heading
  • Add FAQ structured data for search engines Use on one page only, and only for questions your shop answers itself.
  • Color scheme

Blocks

Question
  • Question
  • Answer
Hero
  • Layout Options: Text and images side by side, Text over image, Text only.
  • Small text above heading
  • Heading Italic words get the highlight color.
  • Text
  • Button label
  • Button link
  • Second button label
  • Second button link
  • Price callout
  • Label For example "Prices from". Leave blank to hide.
  • Show the lowest price in this collection
  • Text over image
  • Height
  • Image overlay
  • Color scheme

Blocks

Image
  • Image
Highlight
  • Icon Options: Delivery, Returns, Secure, Guarantee, Eco, Paw, Home, Sparkle.
  • Text
Pill
  • Text
Image with text
  • Image
  • Image position on desktop Options: Left, Right.
  • Image shape Options: Square, Portrait, Landscape.
  • Small text above heading
  • Heading
  • Text
  • Button label
  • Button link
  • Color scheme
Contact form
  • Heading
  • Color scheme
Scrolling text
  • Separator Options: Sparkle, Paw, Heart, Star, Leaf.
  • Speed Stops for visitors who prefer reduced motion.
  • Color scheme

Blocks

Text
  • Text
Multicolumn
  • Small text above heading
  • Heading
  • Column top Options: Icon, Image, Step number, Nothing.
  • Show columns as cards
  • Color scheme

Blocks

Column
  • Icon Options: Delivery, Returns, Secure, Guarantee, Eco, Heart, Support, Gift, Paw, Home, Sparkle.
  • Image
  • Heading
  • Text
  • Link label
  • Link
Email signup
  • Heading
  • Text
  • Show in a card
  • Subscribers are added to your customer list with the tag "newsletter".
  • Color scheme
Product recommendations
  • Heading
  • Products Complementary products are set with the Search & Discovery app; nothing shows until you add them. Options: Related, Complementary.
  • Products to show
  • Columns on desktop
  • Color scheme
Rich text
  • Alignment Options: Center, Left.
  • Color scheme

Blocks

Small text
  • Text
Heading
  • Heading
Text
  • Text
Button
  • Label
  • Link
  • Outline style

Sections that belong to a page type, such as the product page or the cart:

Cart drawer
  • Color scheme
Header
  • Menu Add a third menu level to turn a dropdown into a mega menu.
  • Logo position on desktop Options: Left, Center.
  • Stay at the top when scrolling
  • Color scheme
  • Mega menu promotion
  • Shown in the first menu item's mega menu.
  • Image
  • Caption
  • Link
Page not found
  • Color scheme
Blog post
  • Show author
  • Color scheme
Blog posts
  • Show excerpt
  • Color scheme
Cart
  • Color scheme
Product grid
  • Show collection banner
  • Show collection description
  • Banner color scheme
  • Products per page
  • Columns on desktop
  • Columns on mobile Options: 1, 2.
  • Show feature points
  • Filters Choose filters in the Search & Discovery app. Options: In a drawer, Sidebar on desktop, Off.
  • Color scheme
Collections list page
  • Heading
  • Color scheme
Page
  • Color scheme
Password page
  • Heading Leave blank to use the message from Online Store preferences.
  • Show email signup
  • Color scheme
Product information App blocks
  • Color scheme
  • Show breadcrumbs
  • Media
  • Desktop layout Options: Slideshow with thumbnails, Grid.
  • Media width on desktop Options: Small, Medium, Large.
  • Media shape Options: Square, Portrait, Landscape.

Blocks

Badges

No settings.

Title

No settings.

Vendor

No settings.

Price

No settings.

SKU

No settings.

Text
  • Text
Variant picker and buy buttons
  • Variant picker Options: Buttons and swatches, Dropdowns.
  • Show quantity selector
  • Show dynamic checkout buttons Customers see their preferred payment method, such as Shop Pay or PayPal.
  • Show in a card
Inventory status
  • Show "low stock" at or below Uses your real Shopify inventory. Hidden for products that don't track inventory.
Service highlights
  • Only list services you actually provide.
  • Icon 1 Options: Delivery, Returns, Secure, Guarantee, Eco, Gift, Time.
  • Text 1
  • Icon 2 Options: Delivery, Returns, Secure, Guarantee, Eco, Gift, Time.
  • Text 2
  • Icon 3 Options: Delivery, Returns, Secure, Guarantee, Eco, Gift, Time.
  • Text 3
Description

No settings.

Collapsible tab
  • Heading
  • Content Specifications read the product metafield custom.specifications (multi-line text, one "Name: value" per line). Options: Text and page below, Product description, Specifications metafield.
  • Text
  • Page
  • Open by default
Custom Liquid
  • Custom Liquid Add app snippets or other Liquid code.

Questions

I can’t see filters on my collection pages

Install Shopify’s free Search & Discovery app and add filters there. They then appear in the Product grid section.

How do I add a “New” badge to a product?

Add the product tag badge:New. Any text after badge: becomes the badge.

The local pickup message doesn’t show

It appears only when a location offers local pickup for that product. Check Settings, Shipping and delivery, Local pickup.

Where is the account button?

It shows when customer accounts are turned on in Settings, Customer accounts.

Can I use apps with Tumble?

Yes. Apps can add blocks to the product page and app embeds to the whole store. Tumble doesn’t need any app to work.

Why do I see placeholder images?

Sections show placeholders until you choose your own images, products or collections in the theme editor.

Support

Every Boopy theme comes with support from the people who made it.

What we help with

  • Questions about theme settings, sections and features.
  • Bugs in the theme, such as a broken layout or a feature that doesn't work as described here.
  • Problems installing or updating the theme.

What isn't included

  • Custom code changes or design work.
  • Problems caused by edits to the theme code or by third-party apps. We'll still tell you if we can see the cause.
  • Your Shopify account, billing, payments or domains. Shopify Support handles those.

How fast we reply

We reply within two business days, Monday to Friday (UK time), not counting UK public holidays.

Before you edit theme code

Always duplicate your theme first (Online Store, Themes, then Duplicate in the theme's menu). We can't support code that has been changed. For custom work, consider hiring a Shopify Partner.

Contact support