Inkblot documentation Version 1.0.0

Sections reference

Every section in Inkblot, with its settings and blocks as the theme editor labels them. Sections marked can be added appear under Add section; the others belong to a specific template, the header or the footer.

404 page

SettingTypeWhat it does
HeadlineTextLeave blank for the default wording.
Second lineTextShown in gray under the headline. Leave blank for the default wording.
Show searchCheckboxDefault: on.

Add to cart confirmation

A small confirmation in the corner whenever something is added, with a countdown to auto-dismiss.

SettingTypeWhat it does
Time on screenSliderFrom 2 to 10 s. Default: 4.2.

AI Stylist

can be added, not in the header or footer

SettingTypeWhat it does
Product poolCollectionWhich collection the stylist may pick from. Defaults to all products.
Maximum products to loadSliderFrom 50 to 250. Default: 250.
AudienceDrop-downOptions: All, Menswear, Womenswear. Default: All.
Show the living gardenCheckboxThe animated scene behind the stylist. Turn off for a plain black background. Default: on.
Fast modeCheckboxShortens the build sequence. Useful while setting the section up. Default: off.
Product type mappingMulti-line textOptional JSON mapping your product types to garment slots. Overrides what the stylist infers.

Block: Headline phrase

SettingTypeWhat it does
First lineText 
Second lineText 

Block: Refine chip

SettingTypeWhat it does
LabelText 
RefinementDrop-downOptions: More casual, Smarter, Warmer, Cooler, Bolder, Simpler, Cheaper. Default: More casual.

Announcement bar

can be added

SettingTypeWhat it does
Announcement textTextDefault: Add your announcement here.

Area of expertise

can be added, not in the header or footer

SettingTypeWhat it does
Heading, first lineTextDefault: WHAT WE.
Heading, second lineTextDefault: STAND FOR?
SubtitleMulti-line textDefault: Describe what your brand stands for in a sentence or two.
Card back monogramTextOne letter on the back of every card. Leave blank for the theme's ink drop. U and F are drawn to match the deck; any other letter is set in the heading font.
Card back imageImageShown on the back of every card. The same image is used for all of them.

Block: Expertise item

SettingTypeWhat it does
HeadingText 
Keycap letterTextA single letter shown as a keyboard-style icon, e.g. "C".
IconImage 
ServicesMulti-line textOne per line.

Blog post

SettingTypeWhat it does
Show excerptCheckboxShown in gray under the heading. Nothing is shown when the article has no excerpt. Default: on.
Featured image shapeDrop-downTall images are capped at 70% of the screen height whichever shape you choose. Options: Original shape, Wide, Tall. Default: Original shape.
Show topicsCheckboxLinks back to the blog, filtered by that topic. Default: on.
Show previous and nextCheckboxNothing is shown when the article has no neighbors. Default: on.

Blog posts

SettingTypeWhat it does
Articles per pageSliderShopify shows at most 50 articles on one page. From 4 to 24. Default: 12.
Second lineTextShown in gray under the blog name. Leave blank for none. A topic filter replaces it.
Show topicsCheckboxShows the first 12 topics. The topic being viewed is always shown. Default: on.
Show authorCheckboxOn a single-author blog the same name repeats down the page. Default: off.

Cart drawer

Slides in when a shopper adds to cart, so they never lose their place. Shown on every page.

SettingTypeWhat it does
Open when an item is addedCheckboxTurn off to show only the confirmation toast instead. Default: off.
Recently viewed productsSliderFrom 2 to 12. Default: 6.
Show accelerated checkout buttonsCheckboxButtons for wallets like Shop Pay and Apple Pay appear when they are enabled in your payment settings. Default: on.

Cart page

SettingTypeWhat it does
Empty-bag screensaver imageImageDrifts across the screen when the bag is empty, bouncing off each edge. Leave unset to fall back to the animation URL below, or to the theme's own badge.
Empty-bag screensaver animation URLTextAn animated image (WebP or GIF) for the bouncing badge, used when no image is uploaded above. It is fetched from wherever you point it, so use artwork you own or are licensed to use — and it will disappear if that address stops serving it.
Show order noteCheckboxDefault: on.
Show accelerated checkout buttonsCheckboxButtons for wallets like Shop Pay and Apple Pay appear when they are enabled in your payment settings. Default: on.

Cart recovery banner

can be added, not in the header or footer

A full-screen modal offering a shopper their saved or recently viewed products. Off by default.

SettingTypeWhat it does
Show automaticallyCheckboxOpens a few moments after the page loads. Default: off.
Brand nameTextLeave blank to use your store name.
Headline (cart has items)Multi-line textDefault: Complete Your Signature Look.
Headline (cart is empty)Multi-line textDefault: Discover Your Signature Look.
TaglineTextDefault: Your personalized selection is waiting.
Button labelTextDefault: GET THE FULL LOOK.
Button linkLinkLeave empty to use the cart page.

Cart reminder

Shown to a returning visitor who left items in their cart. Never on a first visit, never with an empty cart, and never twice within its cooldown — 24 hours after they head to checkout, 4 hours after they dismiss it.

SettingTypeWhat it does
Show the reminderCheckboxDefault: off.
HeadingTextDefault: Your Wardrobe Awaits.
MessageMulti-line textDefault: The pieces you selected are waiting in your cart.
Button labelTextDefault: Secure My Pieces.
Delay before it appearsSliderCounted from when the page loads. From 1 to 20 s. Default: 3.

Collection grid

SettingTypeWhat it does
Show the collection title and descriptionCheckboxDefault: on.
Card styleDrop-downOptions: Grid, Editorial. Default: Grid.
Products per pageSliderFrom 8 to 40. Default: 20.

Collections list

SettingTypeWhat it does
Collections per pageSliderFrom 6 to 24. Default: 12.

Confetti call to action

can be added, not in the header or footer

SettingTypeWhat it does
KickerTextDefault: THIS SEASON'S ARRIVALS ARE IN.
Headline, first lineTextDefault: Wear.
Headline, second lineTextDefault: the new.
Button labelTextDefault: NEW ARRIVALS →.
Button linkLink 
Swipe hintTextShown briefly to touch visitors who try to scroll through the section without triggering it. Default: swipe up fast to continue ↓.

Contact

can be added, not in the header or footer

SettingTypeWhat it does
EyebrowTextDefault: CONTACT.
Heading, first lineTextDefault: LET'S MAKE.
Heading, second lineTextDefault: SOMETHING.
Intro paragraphMulti-line textDefault: Need to get in touch? Send us a note and we'll come back to you as soon as we can.
Accessible name for the details columnTextDefault: Other ways to reach us.

Form

SettingTypeWhat it does
Name field labelTextDefault: Name.
Email field labelTextDefault: Email.
Phone field labelTextDefault: Phone (optional).
Message field labelTextDefault: Message.
Submit buttonTextDefault: Send it.
Message shown after sendingTextDefault: Thanks — that's with us. We'll be in touch shortly.

Block: Contact detail

SettingTypeWhat it does
LabelTextDefault: Visit.
ValueMulti-line textDefault: 123 Example Street, City, ZIP code.
Link (optional)Link 
Note (optional)Text 

Custom Liquid

can be added

SettingTypeWhat it does
LiquidLiquidAdd app snippets or your own Liquid, HTML or Liquid objects.

FAQ page

can be added, not in the header or footer

SettingTypeWhat it does
HeadingTextDefault: FAQs.
Intro textTextDefault: Find answers to commonly asked questions below.

Block: Question

SettingTypeWhat it does
QuestionText 
AnswerMulti-line textOne paragraph per line. Answers expand to their full height, so there is no length limit.

can be added, not in the header or footer

SettingTypeWhat it does
ProductProduct 
Loop product videosCheckboxDefault: off.

Also accepts app blocks from apps you have installed.

Block: Title

No settings.

Block: Price

No settings.

Block: Variant picker

No settings.

Block: Quantity selector

No settings.

Block: Buy buttons

SettingTypeWhat it does
Show dynamic checkout buttonsCheckboxCustomers see the payment methods you offer, like Shop Pay, Apple Pay or PayPal. Default: on.
Show gift card recipient formCheckboxOn gift card products, customers can send the card to someone else, with an optional message and delivery date. Default: on.

Block: Description

No settings.

Block: Text

SettingTypeWhat it does
TextRich text 

can be added, only in the footer

Tagline

SettingTypeWhat it does
Tagline, first lineTextEach line reveals separately, rising from behind a mask. Default: Add a tagline.
Tagline, second lineTextDefault: across two lines.
Mission statementMulti-line textDefault: Use this space to tell customers what you make and why.

Details

SettingTypeWhat it does
Brand markTextLeave blank to use your store name.
AddressMulti-line textOne line per row. Leave empty to hide.

Email signup

SettingTypeWhat it does
Show email signupCheckboxSignups are added to your customers with the tag "newsletter". Default: on.
TextRich text 

Social accounts are set once for the whole theme, in Theme settings > Social media.

Block: Link column

SettingTypeWhat it does
HeadingText 
MenuMenu 
Emphasize this columnCheckboxDefault: off.

only in the header

Brand

SettingTypeWhat it does
LogoImageLeave empty to use the wordmark below.
Logo markImageThe emblem shown beside the name. Leave empty to use the theme’s built-in mark, which follows the header’s color as it inverts.
WordmarkTextLeave blank to use your store name.
Show the trailing dotCheckboxDefault: on.

Appearance

SettingTypeWhat it does
Let content run behind the headerCheckboxTurn on for templates that open with a full-bleed hero. Off reserves space so nothing is hidden underneath. Default: off.
Adapt to the section behind the headerCheckboxThe bar goes transparent and inks white over dark heroes, and returns to the solid light bar over light sections. Turn off if your hero is light. Default: on.
Announcement intervalSliderFrom 2 to 10 s. Default: 4.

Mega menu

SettingTypeWhat it does
Mega menu labelTextDefault: Shop.

Actions

SettingTypeWhat it does
Cart button labelTextDefault: Shopping Cart.

Block: Announcement

SettingTypeWhat it does
TextTextDefault: Add your delivery message.
EmphasizeCheckboxDefault: off.

Block: Navigation link

SettingTypeWhat it does
LabelText 
LinkLink 
BadgeTextA short word such as New. Leave empty to hide.

Block: Mega menu column

SettingTypeWhat it does
HeadingText 
MenuMenuLinks to collections fill in their own image and description. Add a Mega menu override to change either, or for links that are not collections.

Block: Mega menu item

Belongs to the mega menu tab above it. Use these when you want the theme to carry its own navigation; a tab with a menu selected ignores them.

SettingTypeWhat it does
LabelText 
LinkLink 
DescriptionText 
BadgeTextShown on the right of the row. Defaults to “Explore”.
ImageImageOptional. Without one, the linked collection’s featured image is used.

Block: Mega menu override

Replaces the image, description or badge for one link in a mega menu column. Match it by choosing the same link.

SettingTypeWhat it does
Link to overrideLink 
ImageImage 
DescriptionText 
BadgeText 

Hero

can be added, not in the header or footer

SettingTypeWhat it does
Autoplay intervalSliderHow long each slide stays before advancing. Only matters with more than one slide. From 4 to 20 s. Default: 12.

Block: Slide

SettingTypeWhat it does
ImageImage 
Mobile imageImageA separate, taller crop shown below 768px. Leave empty to reuse the image above.
Alt textText 

New arrivals helix

can be added, not in the header or footer

SettingTypeWhat it does
CollectionCollectionThe products that spin on the helix. Point this at New Arrivals and the section stays correct as stock turns over. Leave it blank to show all products.
HeadingTextDefault: New Arrivals.
SubheadingMulti-line textDefault: Scroll or swipe to spin the helix and explore the collection.
Products shownSliderMore products take longer to load, especially on phones. From 8 to 32. Default: 24.

Outfit

can be added, not in the header or footer

SettingTypeWhat it does
DescriptionMulti-line textDefault: Say who you are and why this collection exists. Two sentences is plenty — this sits beside the categories, not above them.
Left column labelTextDefault: OUTFIT.
Middle column labelTextDefault: WHY.
First link labelTextDefault: VISIT ++ WEBSITE.
Second link labelTextDefault: SHIPPING AND RETURNS.
Copyright lineTextDefault: © 2026.

Block: Category

SettingTypeWhat it does
HeadingText 
CollectionCollectionProducts and imagery are pulled from this collection.
Fallback imageImageUsed when the collection has no image of its own.

Page

SettingTypeWhat it does
Show the page titleCheckboxTurn this off if your page content already opens with its own heading. Default: on.
Content widthDrop-downNarrow keeps text at a comfortable reading measure. Widen it for pages built as landing pages. Options: Narrow, Medium, Wide. Default: Narrow.

Page transition

A full-screen wipe between pages, with your wordmark. It delays each navigation by about a second, and is automatically off for reduced-motion visitors and low-powered devices.

SettingTypeWhat it does
Show the transitionCheckboxDefault: on.
WordmarkTextLeave empty to use your store name.
SpeedSliderLower is slower. 0.8 is the default pace. From 0.5 to 1.5. Default: 0.8.

Password page

SettingTypeWhat it does
LogoImageLeave blank to use the logo from your store's brand settings, or your store name.
HeadlineTextLeave blank for the default wording.
Second lineTextShown in gray under the headline. Leave blank for the default wording.
Show email signupCheckboxSignups are added to your customers with the tag "newsletter". Default: on.

Pickup availability

Product information

SettingTypeWhat it does
BadgeTextA short line above the description, e.g. "Limited edition". A product's custom.badge metafield overrides it.
Model heights on the size cardsTextA comma-separated list, one height per size in size order. If there are fewer heights than sizes, the last one repeats. A product’s custom.model_heights metafield replaces it. Leave blank to show the sizes alone.
Loop product videosCheckboxDefault: off.

Also accepts app blocks from apps you have installed.

Block: Title

No settings.

Block: Description

No settings.

Block: Price

No settings.

Block: Variant picker

No settings.

Block: Quantity selector

No settings.

Block: Buy buttons

SettingTypeWhat it does
Show dynamic checkout buttonsCheckboxCustomers see the payment methods you offer, like Shop Pay, Apple Pay or PayPal. Default: on.
Show pickup availabilityCheckboxShows where the selected variant can be picked up, if you offer local pickup. Default: on.
Show gift card recipient formCheckboxOn gift card products, customers can send the card to someone else, with an optional message and delivery date. Default: on.

Block: Text

SettingTypeWhat it does
TextRich text 

Reviews

can be added, not in the header or footer

SettingTypeWhat it does
HeadingTextDefault: Reviews.

Also accepts app blocks from apps you have installed.

Scroll typography

can be added, not in the header or footer

SettingTypeWhat it does
SentenceTextDefault: Some are seen. You'll be remembered.

Search results

Similar to

can be added, not in the header or footer

SettingTypeWhat it does
HeadingTextDefault: Similar to.
Products shownSliderFrom 2 to 6. Default: 3.

Specs and reviews

can be added, not in the header or footer

Complete the look

SettingTypeWhat it does
HeadingTextDefault: Complete the Look.
SubtitleMulti-line textDefault: Pieces that pair well with this one.
Pieces in a lookSliderHow many products make up one look. "Try another" swaps in this many at a time. From 2 to 4. Default: 3.

Outfit slots

Each slot draws from its own collection, so the look is a real outfit rather than more of the same category. Leave all five empty to use Shopify recommendations instead.

SettingTypeWhat it does
Layer (jackets, knitwear)Collection 
Bottom (trousers, shorts)Collection 
ShoesCollection 
Top (tees, shirts)Collection 
Finish (accessories)Collection 
Products fetchedSliderThe pool "Try another" draws from. More than the slot count is what makes the button do anything. From 2 to 10. Default: 9.

Pinned reviews

SettingTypeWhat it does
Show the review score pillCheckboxUses the product’s own rating metafield when it has one, and the score below when it does not. Only turn this on if the figure is real. Default: off.
Review provider nameTextSuch as Trustpilot.
Fallback score out of 5TextShown on products with no rating metafield. Leave blank to show the pill only on products that have one.

Shop footer

SettingTypeWhat it does
Shop footer lineTextA single line printed under the module, e.g. your store name, founding year and order line. Blank hides it.

Block: Pinned review

SettingTypeWhat it does
QuoteMulti-line text 
RatingSliderFrom 1 to 5. Default: 5.
DateText 
Product reviewedTextLeave blank to use this product’s name.
Country codeText 
Verified buyerCheckboxDefault: off.

Testimonials

can be added, not in the header or footer

SettingTypeWhat it does
Masthead label, leftTextDefault: FILED · REVIEWS.
Masthead label, middleTextDefault: VOL. I.
Masthead label, rightTextDefault: MMXXVI.
Heading, italic wordTextDefault: The.
Heading, bold wordTextDefault: Wall.
SubtitleMulti-line textDefault: Voices from the field.
Service scoreTextOut of 5. Leave blank to hide it.
Product scoreTextOut of 5. Leave blank to hide it.
Reviews countTextLeave empty to show the number of review blocks below instead.
Trading sinceTextA year, such as 2018. Leave blank to hide it.
Review platformTextThe service that collects and verifies your reviews, such as Trustpilot. Adds a verified stamp to each review and names the service in the link to all reviews. Leave blank if your reviews are not verified by one.
Link to all reviewsLink 

Award badge

SettingTypeWhat it does
HeadingTextSuch as the name of an award your store holds. Leave blank to hide the badge.
SubheadingText 
YearText 

Block: Review

SettingTypeWhat it does
NameText 
LocationText 
ProductText 
DateText 
QuoteMulti-line text 
Note sizeDrop-downOptions: Small, Medium, Large. Default: Medium.
Dark noteCheckboxDefault: off.

Who we are

can be added, not in the header or footer

SettingTypeWhat it does
Eyebrow labelTextDefault: IDENTITY.
FAQ headingTextDefault: FAQ.

Block: Story panel

SettingTypeWhat it does
HeadingText 
BodyMulti-line textOne paragraph per line. Plain text only: this page re-wraps every line to animate it, so bold, links and manual line breaks are not kept. Around six panels reads best, and the numbering stops at two digits.

Block: FAQ

SettingTypeWhat it does
QuestionText 
AnswerMulti-line text