Placebo 1.0.0 / Documentation

Cart

The cart can open as a drawer over the page or as its own page. Both have the same settings. This page covers the cart type, the order extras, suggested products, free shipping and the empty cart.

Drawer or page#

Choose the cart type under Theme settings > Cart > Cart type.

  • Drawer: the cart opens as a sheet over the page when a product is added and from the cart control in the header. Its settings are on the Cart drawer section. To reach them, open the cart in the theme editor preview or select Cart drawer in the sidebar.
  • Page: customers go to the cart page. Its settings are on the Cart section of the cart template.

The cart page always exists. It is where the drawer sends a customer whose browser has JavaScript turned off. If you use the drawer, keep the two sections set the same way.

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

Checkout area#

Cart drawer settings
SettingWhat it does
Show Shop Pay Installments termsShopify writes the installments sentence under the total when Shop Pay Installments is active in your payment settings and the cart qualifies. Otherwise nothing is shown. Checkbox. On by default.
Show dynamic checkout buttonsShop Pay, Apple Pay, PayPal and the other accelerated methods of your payment settings, above the checkout button. Buttons keep the colors of their payment method. When the store offers none, the checkout button stands alone. Checkbox. On by default.
Show payment iconsThe logos of the payment methods enabled in your payment settings, under the checkout button. Checkbox. On by default.
Show delivery and returns statementsWrites the return window and the guarantee from theme settings, under Delivery and returns, as statements under the checkout button. Type your own statements below to replace them. Checkbox. On by default.
Trust statementsOne per line, up to four. To add an explanation shown on hover, focus or tap, write it after a vertical bar: Label | Explanation. Text, several lines.
Text under the buttonUse it for terms the customer accepts at checkout, like renewal terms. Text.
Keep checkout button in viewCheckbox. On by default.

The order of the checkout area is fixed: dynamic checkout buttons, then the checkout button, then terms, payment icons and statements. Dynamic checkout buttons keep the colors of their payment method.

Order extras#

Cart drawer settings
SettingWhat it does
Show free shipping progressA plain statement with a thin line that fills as the order nears the threshold. Shown only when free shipping starts at an order value, and only to customers who pay in your store currency, so the amount is always true. Checkbox. On by default.
Estimated deliveryShown as a row of the order. Leave empty to use the delivery time from theme settings. Text.
Show order noteA quiet row, Add a note, under the order. Checkbox. On by default.
Show shipping estimateA quiet row that opens on country, province and postal code, and lists your real shipping rates for the cart. The destination is prefilled from the customer's address or market and remembered for the visit. Checkbox. On by default.
Show discount code fieldA quiet row that opens on a field. Shopify checks the code and the discount shows in the order before checkout. Checkbox. Off by default.
Instruction field nameAdds a text field saved with the order under this name, for example: Delivery instructions. Leave empty to hide. Text.
Show gift optionCheckbox. Off by default.
Gift option labelText.
Show gift message fieldCheckbox. On by default.

Shipping estimate#

Show shipping estimate adds a row that opens on country, province and postal code fields. It lists the real shipping rates of your store for the current cart, taken from your shipping settings. The destination is prefilled from the customer's address or market and remembered for the visit. Nothing is estimated by the theme itself.

Order note, instructions and gift option#

  • Show order note adds a row, Add a note, under the order. The note is saved with the order.
  • Instruction field name adds a text field saved with the order under the name you type, for example Delivery instructions.
  • Show gift option adds a checkbox with the label you set in Gift option label, and a message field when Show gift message field is on. Both are saved with the order as order details. The theme does not add a gift wrap product or a fee.

Discount code field#

Show discount code field is off by default. When on, a row opens on a field. Shopify checks the code and the discount shows in the order before checkout. Automatic discounts are always shown in the cart, with or without this field.

Free shipping#

The cart can show a statement and a thin progress line that fills as the order nears your free shipping threshold.

  1. Under Theme settings > Delivery and returns, set Free shipping to From an order value and type the amount in Free shipping from.
  2. In the cart section, keep Show free shipping progress on.
  3. In your Shopify admin, create the matching free shipping rate under Settings › Shipping and delivery. The theme states free shipping. It does not create the rate.

The progress line is shown only to customers who pay in your store currency, so the amount is always true.

Suggested products#

Cart drawer settings
SettingWhat it does
Show suggested productsCheckbox. On by default.
Suggested products headingText.
SourceComplementary products are chosen per product in the Search and Discovery app. When Shopify has nothing to suggest, the products chosen below are shown. Choices: Complementary, then related products, Related products, Only the products chosen below. Default: Complementary, then related products.
ProductsShown when the source has nothing to suggest, or always with the last source. Product list.
Always show suggestionsWhen nothing else is left to suggest, fills the list with products from your catalog, in the order of the All products collection. Also used for the empty cart. Checkbox. On by default.
Maximum suggested productsRange: 1 to 4. Default: 2.

Suggestions are rows with an add button. With Complementary, then related products, the cart first shows the complementary products you chose for the items in the cart in the Shopify Search and Discovery app, then Shopify's related products. Products already in the cart are not suggested.

Empty cart#

Cart drawer settings
SettingWhat it does
Show the large figureCheckbox. On by default.
Empty cart headingLeave empty to use the default sentence in the store language. Text.
TextText.
Button labelText.
Button linkLeave empty to link to all products. Link.
Products to start withShown as rows with an add button. Leave empty to use the collection below. Product list.
Collection to start withCollection.
Maximum products to start withRange: 1 to 6. Default: 3.
Heading above the products to start withText.
Quick links menuUp to 6 links shown as small pills, for example your collections. Menu.

What the cart shows for each item#

Each line shows the picture, the title, the selected options, the price, the unit price where it applies, line item properties, the selling plan for subscriptions, and discounts applied to the line. Quantity changes and removals update the cart without reloading the page, and each change is announced to screen readers. Quantity rules set on a variant are respected.

Cart page only#

Cart settings
SettingWhat it does
This page is used when the cart type in theme settings, under Cart, is set to a page. It is also where the sheet sends a customer without JavaScript.
Layout on desktopChoices: 2 columns, 1 column. Default: 2 columns.

The cart page also accepts app blocks and a Custom Liquid block. The drawer has a Liquid code setting for app snippets under the order.

All settings of the Cart section
Cart settings
SettingWhat it does
This page is used when the cart type in theme settings, under Cart, is set to a page. It is also where the sheet sends a customer without JavaScript.
Layout on desktopChoices: 2 columns, 1 column. Default: 2 columns.
Checkout
Show Shop Pay Installments termsShopify writes the installments sentence under the total when Shop Pay Installments is active in your payment settings and the cart qualifies. Otherwise nothing is shown. Checkbox. On by default.
Show dynamic checkout buttonsShop Pay, Apple Pay, PayPal and the other accelerated methods of your payment settings, above the checkout button. Buttons keep the colors of their payment method. When the store offers none, the checkout button stands alone. Checkbox. On by default.
Show payment iconsThe logos of the payment methods enabled in your payment settings, under the checkout button. Checkbox. On by default.
Show delivery and returns statementsWrites the return window and the guarantee from theme settings, under Delivery and returns, as statements under the checkout button. Type your own statements below to replace them. Checkbox. On by default.
Trust statementsOne per line, up to four. To add an explanation shown on hover, focus or tap, write it after a vertical bar: Label | Explanation. Text, several lines.
Text under the buttonUse it for terms the customer accepts at checkout, like renewal terms. Text.
Keep checkout button in viewCheckbox. On by default.
Order
Show free shipping progressA plain statement with a thin line that fills as the order nears the threshold. Shown only when free shipping starts at an order value, and only to customers who pay in your store currency, so the amount is always true. Checkbox. On by default.
Estimated deliveryShown as a row of the order. Leave empty to use the delivery time from theme settings. Text.
Show order noteA quiet row, Add a note, under the order. Checkbox. On by default.
Show shipping estimateA quiet row that opens on country, province and postal code, and lists your real shipping rates for the cart. The destination is prefilled from the customer's address or market and remembered for the visit. Checkbox. On by default.
Show discount code fieldA quiet row that opens on a field. Shopify checks the code and the discount shows in the order before checkout. Checkbox. Off by default.
Instruction field nameAdds a text field saved with the order under this name, for example: Delivery instructions. Leave empty to hide. Text.
Show gift optionCheckbox. Off by default.
Gift option labelText.
Show gift message fieldCheckbox. On by default.
Suggested products
Show suggested productsCheckbox. On by default.
Suggested products headingText.
SourceComplementary products are chosen per product in the Search and Discovery app. When Shopify has nothing to suggest, the products chosen below are shown. Choices: Complementary, then related products, Related products, Only the products chosen below. Default: Complementary, then related products.
ProductsShown when the source has nothing to suggest, or always with the last source. Product list.
Always show suggestionsWhen nothing else is left to suggest, fills the list with products from your catalog, in the order of the All products collection. Also used for the empty cart. Checkbox. On by default.
Maximum suggested productsRange: 1 to 4. Default: 2.
Empty cart
Show the large figureCheckbox. On by default.
Empty cart headingLeave empty to use the default sentence in the store language. Text.
TextText.
Button labelText.
Button linkLeave empty to link to all products. Link.
Products to start withShown as rows with an add button. Leave empty to use the collection below. Product list.
Collection to start withCollection.
Maximum products to start withRange: 1 to 6. Default: 3.
Heading above the products to start withText.
Quick links menuUp to 6 links shown as small pills, for example your collections. Menu.

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

Contact support