checkout.scss.liquid is a stylesheet file and is stored in the Assets directory.
You can make additional style enhancements to your checkout pages by creating a
checkout.scss.liquid asset for your theme. For Plus merchants, the
checkout.scss.liquid file is automatically included in the
checkout.liquid layout. There are some best practices to keep in mind when you're writing your
When you're styling your checkout, remember to consider its component pages. Depending on checkout settings, there are at least four checkout pages, and at most six.
Checkout uses the BEM syntax to minimize nesting. You should avoid deep nesting of selectors, and use the simplest selector that meets your needs.
For example, to style the name of the products inside the order summary:
|Use this||Instead of this|
Avoid using !important
Your checkout stylesheet is loaded after the base stylesheet, so there's no need to add
!important to every property. Reserve the use of
!important for cases where it's absolutely necessary.
Consider designing buttons for all states,
Customize your classes to provide button styles that match your theme.
The default stylesheet has four breakpoints, which you can use in your stylesheet:
- Small: 0px and up – does not require a media query
- Medium: 750px and up
- Large: 1000px and up
- Large Desktop: 1300px and up.
Custom webfonts & additional scripts
You can load your self-hosted webfonts directly from the
checkout.scss.liquid using an
Checkout uses SSL encryption to ensure a safe buying experience for your customers. If you do load images or additional content, it must be served via
https:// to be rendered on the page. We recommend that you use our CDN to host all your assets.
A few utility classes are included on the
Browser and OS: for example, a user running Chrome on OS X would have the classes:
Modernizr: we use Modernizr to detect if the browser supports certain CSS properties like RGBA, multiple background images, box-shadows, pseudo-elements, and inline SVG.
You can use these classes to provide an improved checkout experience on older browsers.
Fields, modals, and notices
Field states and classes
Use the classes in your tables to style the three field states to fit your theme.
|Field state||CSS class|
|Default||No class required|
Policies (refund, privacy, and terms of service) and processing/forwarding pages are presented in a full-screen modal.
Use warnings to notify the user that the total cost of their order changed before they completed their purchase. For example if inventory is automatically adjusted.
Use clear error messages to communicate errors to the user.