Placebo 1.0.0 / Documentation

Theme settings

Theme settings apply to the whole store. Open them from the gear icon in the theme editor sidebar. This page follows the order of the groups as they appear there, and quotes every label as it is written in the editor.

Colors#

A color scheme is a named set of colors. Sections and several blocks have a Color scheme setting, so you can give one section a dark ground without touching the rest. Edit, add or remove schemes at the top of the Colors group.

Each scheme has these roles:

Color scheme roles
SettingWhat it does
BackgroundColor. Default: #fbfaf7.
TextColor. Default: #22252d.
Secondary textColor. Default: #676b74.
Card backgroundColor. Default: #ffffff.
Card rimColor. Default: #eceae4.
Media backgroundColor. Default: #e2e5ec.
Button backgroundColor. Default: #22252d.
Button labelColor. Default: #ffffff.
AccentColor. Default: #22252d.

Two settings choose which scheme the store itself uses:

Colors theme settings
SettingWhat it does
Color schemes.
PageColor scheme.
Floating elementsApplies to the header, the product dock, and panels. Color scheme.

Keep Secondary text at a contrast of 4.5:1 or more against Background and Card background. The theme uses it for small labels and notes.

Aurora#

Aurora is a thin band of colored light on the edge of a few elements, such as the buy bar and the password page. It is never used as a fill. Turn it off with Show aurora light, or choose its four colors.

Colors theme settings
SettingWhat it does
Show aurora lightCheckbox. On by default.
First colorColor. Default: #6d4aff.
Second colorColor. Default: #2b6cff.
Third colorColor. Default: #19d3e6.
Fourth colorColor. Default: #ff5cc8.

Typography#

The theme uses three fonts: one for headings, one for body text and one for small labels and figures. Fonts come from the Shopify font library and are loaded from Shopify's servers with your store.

Typography theme settings
SettingWhat it does
HeadingsFont.
Body textFont.
Labels and figuresUsed for small labels and sources. Font.
Heading sizeRange: 80 to 130%. Default: 100%.
Body text sizeEvery text size on the store scales with this value. Range: 12 to 18 px. Default: 13 px.
Heading letter spacingChoices: Tight, Normal, Wide. Default: Tight.
Show labels in uppercaseCheckbox. Off by default.
Heading caseChoices: As written, Uppercase. Default: As written.

Body text size is the base of the type scale. If you raise it from 13 px to 15 px, headings, labels and spacing tied to type all grow with it. Use Heading size to change headings alone.

Shape and material#

These settings change the character of the store more than any others. They apply everywhere at once so corners, cards and controls stay consistent.

Shape and material theme settings
SettingWhat it does
Corner styleApplies to buttons, cards, fields, media, and panels together so every corner stays concentric. Choices: Pill, Soft, Square. Default: Pill.
Floating element materialGlass blurs and brightens the content behind the header, the dock, and gallery controls. Choices: Glass, Frosted, Solid. Default: Glass.
Card styleChoices: Rim, Line, Plain. Default: Rim.
Ledger rule styleChoices: Dotted leaders, Solid lines, None. Default: Dotted leaders.
Media shapeApplies to the gallery, product cards, and large pictures. Arch rounds the top and keeps the foot square. Choices: Follow the corner style, Arch, Fully rounded. Default: Follow the corner style.
Button styleOutline draws the main buttons with a clear ground and a 1 px line in the text color. They fill on hover. Choices: Solid, Outline. Default: Solid.
Show paper grainA fine texture over the page background. Checkbox. Off by default.
  • Corner style: Pill gives fully rounded buttons and large card radii. Soft reduces every radius. Square removes them.
  • Floating element material applies to the header, the buy bar and the controls that sit on pictures. Choose Solid if you prefer no blur behind them.
  • Card style: Rim draws a thick light border around a white card. Line draws a hairline. Plain draws nothing.
  • Ledger rule style sets how rows of facts are drawn, for example in the product label: with dotted leaders between the name and the value, with solid lines, or with neither.

Layout#

Layout theme settings
SettingWhat it does
Text column widthThe width of the reading column on product pages and text sections. Range: 440 to 680 px. Default: 520 px.
Grid spacingRange: 4 to 32 px. Default: 10 px.

Text column width is the width of the product page column and of every section set to the reading column. Wider columns suit larger body text.

Motion#

Motion theme settings
SettingWhat it does
Motion levelVisitors who ask their device to reduce motion always get none. Choices: Full, Calm, None. Default: Full.
Show content as it enters the screenCheckbox. On by default.
Page transitionsCrossfades from one page to the next and prefetches the page a visitor is about to open. Skipped for visitors who ask for reduced motion. Checkbox. On by default.

Full plays every arrival: titles that rise word by word, lines that draw, cards that follow one another. Calm keeps short fades. None turns arrivals off. Visitors whose device asks for reduced motion always get the reduced version, whatever you choose. Sections also have their own Arrival setting, described in Sections and blocks.

Product cards#

These settings apply to product cards everywhere: collections, search results, featured collections, recommendations and menu panels.

Product cards theme settings
SettingWhat it does
Image ratioChoices: Adapt to image, Square, Portrait, Tall portrait, Landscape. Default: Portrait.
Show second image on hoverThe second picture fades in over the first. On mobile the first picture shows. Checkbox. On by default.
Show vendorCheckbox. Off by default.
Show color swatchesCheckbox. On by default.
FrameChoices: Plain, Rim card. Default: Plain.
Image fitChoices: Fill the frame, Show the whole image. Default: Fill the frame.
Show ratingUses the product rating metafield when a reviews app fills it. Checkbox. On by default.
Show dynamic checkout buttons in quick addCheckbox. On by default.
Show sibling products as swatchesFor products linked with the product metafield custom.siblings, or with custom.product_group. Checkbox. Off by default.
Actions
ActionsOn the picture: quick view is a round icon at the top right, add is a bar across the foot of the picture. Under the picture: quick view as a text link, add as a small pill. Choices: On the picture, Under the picture, None. Default: On the picture.
Actions on the pictureApplies on desktop, for actions on the picture. On mobile, and on any touch screen, they always show. Choices: On hover, Always visible. Default: On hover.
Show add buttonOne variant: adds straight to the cart. With options: the bar opens a small picker in the picture. Turned off, the card only links to the product page. Checkbox. On by default.
Show quick viewOpens the product as a sheet on the right edge: gallery, price, options, buy buttons and a link to the full page. Checkbox. On by default.
BadgesChoices: On the picture, Under the picture. Default: On the picture.

Quick view and quick add are explained with examples in Collection and search.

Delivery and returns#

Fill this group once. The theme writes the same statements on the product page, in the cart, in the footer and in the Delivery and returns section, so they never disagree.

Delivery and returns theme settings
SettingWhat it does
Set these once. The buy buttons, the product label, the cart, the delivery and returns panel and the foot all read them, so a change here changes every statement in the store.
Free shippingMatch the rates in your shipping settings: the theme states free shipping, it does not create the rate. Choices: Not stated, On every order, From an order value. Default: Not stated.
Free shipping fromOrder value in your store currency. The amount, and the cart's progress line, are shown only to customers who pay in your store currency, so the amount is always true. Number.
Delivery timeCompletes the sentence "Delivery in ...", for example: 2 to 5 business days. Leave empty to hide. Text.
Return window in daysFor example 30. Leave empty to state nothing about returns. Number.
Return shipping is freeCheckbox. Off by default.
Guarantee lengthLeave empty to state no guarantee. Number.
Guarantee unitChoices: Days, Months, Years. Default: Years.
Shipping pageLeave empty to use the shipping policy from your store settings. Link.
Returns pageLeave empty to use the refund policy from your store settings. Link.
Estimated delivery dates
Fewest business days to deliverFrom the day an order leaves. 0 with the setting below at 0 turns the dates off. Range: 0 to 30. Default: 0.
Most business days to deliverRange: 0 to 45. Default: 0.
Order cut-off hourIn the store's time zone, on a 24-hour clock. Orders placed after it leave the next working day. 0 sets no cut-off. Range: 0 to 23. Default: 0.
Working daysChoices: Monday to Friday, Monday to Saturday, Every day. Default: Monday to Friday.

Things to know:

  • The theme states free shipping. It does not create the shipping rate. Set the matching rate under Settings › Shipping and delivery in your Shopify admin.
  • The amount in Free shipping from and the cart's progress line are shown only to customers who pay in your store currency. Customers in other currencies see no amount, so the statement is never wrong after conversion.
  • Estimated delivery dates appear only when Fewest business days to deliver or Most business days to deliver is above 0, and when Show estimated delivery dates is on in the Buy buttons block of the product page.
  • Leave a field empty to state nothing. An empty Return window in days removes every returns statement.

Product badges#

Product badges theme settings
SettingWhat it does
Sale and sold out are automatic. Add your own badges with the product metafield custom.badges, or with product tags that start with the prefix below. The theme has no stock or countdown badge.
Show New forDays after a product is published. Set to 0 to hide. Range: 0 to 90 days. Default: 0 days.
Show custom badgesCheckbox. On by default.
Tag prefixA product tag like badge: Vegan shows the badge Vegan. Left empty, the theme uses badge: as the prefix. Text.
Maximum badges on a product cardRange: 1 to 4. Default: 2.
Sale badgeComputed from the compare-at price and rounded down. A product whose variants save different amounts shows the largest as Up to. Beside the price the saving is always written. Choices: Sale, Percent saved, Amount saved. Default: Percent saved.
Sale colorFills the sale badge under white words. Keep it dark enough for white text: 4.5:1 or more. Color. Default: #C62828.

Badges appear in this order: sold out or sale, then New, then your own badges. To add your own, use product tags that start with the Tag prefix, or the product metafield custom.badges described in Custom data. For example, the tag badge: Vegan shows a badge that reads Vegan.

Cart#

Cart theme settings
SettingWhat it does
Cart typeChoices: Drawer, Page. Default: Drawer.
Show cart noteCheckbox. On by default.
Show vendorCheckbox. Off by default.

Drawer opens the cart as a sheet over the page. Page sends customers to the cart page. The settings of the cart itself are on the Cart drawer and Cart sections. See Cart.

Brand#

Brand theme settings
SettingWhat it does
Favicon32 x 32px .png recommended Image.

Social media#

Enter the full address of each account, for example https://instagram.com/yourstore. The accounts are listed by the footer, the menu drawer and the password page when their social settings are on.

Social media theme settings
SettingWhat it does
InstagramText.
TikTokText.
FacebookText.
YouTubeText.
XText.
PinterestText.

Still stuck? We answer within two business days, Monday to Friday.

Contact support