Pigment documentation

Everything you need to set up and run your store with Pigment 1.0.0. Questions this page does not answer? Contact support.

Getting started

Pigment is a color-led Shopify theme for fashion and accessories brands, with shop by color, color stories, shoppable looks and fourteen palettes. The demo store Ciano shows every section with real products: ciano-jh0nrypf.myshopify.com.

Install the theme

  1. In your Shopify admin, go to Online Store > Themes.
  2. Find Pigment in the Theme Store and click Try theme or Add theme.
  3. Click Customize to open the theme editor. Your theme stays unpublished until you click Publish.

Before you start

  • Create your menus in Content > Menus: a Main menu (up to three levels) and a Footer menu.
  • Use product photos in one ratio; portrait 4:5 photos (for example 1600 x 2000px) look best.
  • Install the free Search & Discovery app to set up filters, product recommendations and complementary products.
  • Before you edit theme code, duplicate the theme (Actions > Duplicate) so you can always go back.

Colors and palettes

Pigment uses color schemes. Every section has a Color scheme setting, so you can recolor one section without touching the rest.

Ready-made palettes

Go to Theme settings > Colors > Color palette and choose one of 14 palettes: Pigment, Chalk, Linen, Carbon, Meridian, Atelier, Bloom, Volt, Harvest, Haven, Summit, Studio, Vitality, Craft. A palette recolors the color schemes, and with them the whole store, in one step. Choose Custom color schemes to set every color yourself.

Show palette picker to visitors adds a small bar where visitors can try the palettes; their choice stays in their own browser and changes nothing in your store. Use it on preview or demo stores and keep it off for selling.

Badges

Set the colors of the badges under Colors: Sale badge background, Sale badge text, Sold out badge background, Sold out badge text, Product tag badge background, Product tag badge text.

Typography and layout

Choose fonts in Theme settings > Typography. The fonts come from Shopify's font library, so they load from Shopify's servers and stay fast. Settings: Headings: Font, Font size scale, Letter case, Show emphasized words in italic; Body text: Font, Font size scale; Navigation and buttons: Letter case.

  • Layout: Page width, Space between sections, Horizontal space, Vertical space, Corner radius of color panels.
  • Buttons: Corner radius, Border thickness, Letter case.
  • Inputs: Corner radius.
  • Media: Corner radius, Enable zoom on hover.

Sections

The home page of the demo opens with the sections at the top of this table, in that order. Every section can be added to any page in the theme editor (Add section).

SectionUse it for
SlideshowFull-width slides with a heading, text and buttons; separate pictures for phones. Settings: Height, Desktop image position, Make section full width, Auto-rotate slides, Change slides every, Slideshow description. Blocks: Slide.
Shop by colorShop by color: round color chips that lead to each color, with the number of products. Settings: Subheading, Heading, Text, Show product count. Blocks: Color.
Featured collectionProducts of a collection as a grid or a scrolling row; add collection blocks to show tabs such as New arrivals and Sale. Settings: Subheading, Heading, Link label, Link, Layout, Maximum products to show, Products per row on desktop, Show view all button. Blocks: Collection, Promotion.
Color storiesCards, one per color, each pairing a large picture with products of that shade; they can stack as customers scroll. Settings: Subheading, Heading, Text, Stack cards while scrolling. Blocks: Story.
Collection listCollections as picture tiles with their names and product counts. Settings: Subheading, Heading, Link label, Link, Collections per row on desktop, Show product count. Blocks: Collection.
Shop the lookA picture with points that open the product shown there, and the products as a list beside it. Settings: Image, Desktop layout, Subheading, Heading, Text, Show product list, Show add the look button, Button label. Blocks: Product to wear with, Hotspot.
Image with textA picture beside text blocks: subheading, heading, text, numbers and buttons. Settings: Image, Second image, Desktop layout, Panel color, Text on panel. Blocks: Subheading, Heading, Text, Number with label, Button.
Blog postsThe latest articles of a blog. Settings: Subheading, Heading, Link label, Link, Blog, Number of posts to show, Layout, Show date.
Email signupAn email signup, over a picture if you add one. Settings: Image, Panel color, Text on panel. Blocks: Subheading, Heading, Text, Email form.
AppsBlocks of the apps you installed.
Before and afterTwo pictures with a slider between them. Settings: Before image, Before label, After image, After label, Starting position, Picture shape, Frame, Matte color.
Cart recommendationsProducts suggested for the items in the cart. Settings: Suggestions, Subheading, Heading, Maximum products to show, Products per row on desktop.
Collapsible contentQuestions and answers or details in rows that open and close. Settings: Subheading, Heading, Text, Layout, Open the first row by default. Blocks: Row.
More in this colorProducts of the same color as the product shown ("More in this color"). Settings: Collection, Subheading, Heading, Link label, Maximum products to show.
Complementary productsProducts that go with the one shown (set them in Search & Discovery). Settings: Subheading, Heading, Maximum products to show, Panel color scheme.
Contact formA contact form with your contact details beside it; add form fields as blocks. Settings: Heading, Show page title and content, Image. Blocks: Contact detail, Form field.
CountdownCounts down to a real date you set; after the date it hides or shows your closing text. It never starts again by itself. Settings: End date, End time, Text after the end, Subheading, Heading, Text, Button label, Button link.
Custom LiquidYour own Liquid code. Settings: Liquid code.
Featured productOne product with its pictures, price, options and buy buttons, anywhere on a page. Settings: Product, Desktop layout, Enable image zoom. Blocks: Text, Vendor, Title, Price, Product rating, SKU, Inventory status, Variant picker, Quantity selector, Buy buttons, Description, Collapsible row, Pop-up, Icons with text, Share, Custom Liquid.
Icons with textShort promises with an icon each, for example free shipping or returns. Settings: Heading, Show dividers. Blocks: Item.
Image bannerA full-width picture with a heading, text and up to two buttons over it. Settings: Image, Image overlay opacity, Height, Horizontal content position, Vertical content position. Blocks: Subheading, Heading, Text, Buttons.
PressWhat publications wrote about you: one quote at a time, with their names or logos as tabs. Settings: Subheading, Heading, Panel color, Text on panel. Blocks: Publication.
Quick order listEvery variant of a product in a list with quantity fields, to order many at once. Settings: Product, Subheading, Heading, Show SKU.
Recently viewedThe products the customer looked at last. Settings: Subheading, Heading, Maximum products to show.
Related productsProducts like the one shown. Settings: Subheading, Heading, Maximum products to show, Products per row on desktop.
Rich textA heading, text and a button in the middle of the page. Settings: Content alignment. Blocks: Subheading, Heading, Text, Button.
Scrolling textWords that move across the page in a line. Settings: Speed, Direction, Text size, Show border. Blocks: Text.
MapYour shop or studio: a picture, address, opening hours, phone and a directions button. Settings: Image, Desktop layout, Subheading, Heading, Text, Address, Opening hours, Phone number.
TestimonialsQuotes from your customers, with a name and an optional rating and product. Settings: Subheading, Heading. Blocks: Testimonial.
VideoA Shopify-hosted, YouTube or Vimeo video with a cover picture. Settings: Subheading, Heading, Shopify-hosted video, YouTube or Vimeo link, Cover image, Video description.

Sections that depend on a collection, a blog, a product or a picture stay hidden from shoppers until you choose one; in the theme editor they show placeholders so you can see where they go.

Pop-up and age check

In the theme editor's Overlays group you can add a Promotion pop-up (a picture, text, a discount code to copy, an email signup or a button; it opens after the delay you choose and never over another dialog) and an Age verification (visitors confirm their age before they use the store; the answer is remembered). Both are off until you add them.

Product page

The product page is built from blocks in Product information: add, remove and reorder them in the theme editor.

  • Text: Text, Text style.
  • Vendor: Show product type, Show badges.
  • Title
  • Price
  • Product rating
  • SKU
  • Countdown: Heading, End date, End time, Text after the end.
  • Inventory status: Low inventory threshold, Show inventory count.
  • Variant picker: Style, Size guide page, Option with the size guide, Size guide link label, Swatch.
  • Quantity selector
  • Buy buttons: Show quantity selector, Show price in the button, Show dynamic checkout buttons, Show recipient information form for gift cards, Show pickup availability, Show Pre-order for items sold while out of stock.
  • Delivery estimate: Processing time, Shortest shipping time, Longest shipping time, Orders ship the same day until, Skip weekends, Show the same-day cut-off time.
  • Description: Show in a collapsible row, Heading, Open by default.
  • Collapsible row: Heading, Icon, Row content, Row content from page, Open by default.
  • Pop-up: Link label, Page.
  • Complementary products: Heading, Maximum products to show.
  • Icons with text: First icon, First text, Second icon, Second text, Third icon, Third text.
  • Color story: Show for products tagged, Heading, Text, Link, Card color, Text on card.
  • Share: Text.
  • Custom Liquid: Custom Liquid.

The buy buttons include accelerated checkout (shown only for a variant that can be bought), the gift card recipient form, pickup availability and, when turned on, a back in stock request for sold-out variants that reaches you by email. Products sold with selling plans show their purchase options; variants sold while out of stock can show Pre-order. Quantity rules and volume pricing of B2B catalogs show under the price.

Gallery and settings

Settings of Product information: Desktop media layout, Desktop media size, Open images in a full-screen viewer, Zoom images on hover, Show only the media of the selected color, Enable sticky content on desktop, Tint the page with the selected color, Show sticky add to cart bar, Show breadcrumbs. On computers customers can magnify pictures under the pointer; a full-screen viewer offers zoom, swipe, arrows and keys. When a color is chosen, the gallery can show that color's pictures.

A gift card shows no delivery date, size guide or shipping notes, because it is sent by email.

Collection and search pages

  • Product grid: Products per page, Products per row on desktop, Products per row on tablet, Products per row on mobile, Pagination, Enable filtering, Desktop filter layout, Show color filter above products, Filters open by default, Enable sorting.
  • Filters come from the Search & Discovery app; sorting and the number of products per row sit in the toolbar.
  • Product cards (Theme settings > Product cards): Image ratio, Image fit, Show color matte behind images, Show second image on hover, Show vendor, Show product rating, Show color swatches, Show color name, Show quick add, Text alignment.

The search results page uses the same grid, filters and sorting.

Cart

In Theme settings > Cart: Cart type, Show vendor, Show order note, Free shipping threshold, Show product recommendations, Collection in empty cart, Menu in empty cart, Gift wrapping product.

  • Enter the free shipping amount in your store currency (for example 70) to show progress towards free shipping. Use the same amount as your shipping rates.
  • With a gift wrapping product chosen, customers add or remove it with a switch in the cart.

Languages and right-to-left

Pigment includes Arabic, German, English, Spanish, French, Hebrew, Italian. Add languages in Settings > Languages and translate your own content with Shopify's Translate & Adapt app.

In Arabic and Hebrew the whole layout mirrors: menus, drawers, sliders and the gallery.

Speed and accessibility

  • Pictures load in the right size for each screen, and only when they come near the screen.
  • Effects use only movement and fading. When a customer's device asks for reduced motion, Pigment shows everything without movement.
  • Every control works with the keyboard and screen readers, with visible focus and labelled buttons; Escape closes the open dialog.
  • Theme settings > Animations: Reveal sections on scroll, Enable hover effects, Move large images gently on scroll.

Questions

Why don't my filters show?

Filters come from the Search & Discovery app. Install it and add filters such as Availability, Price, Color and Size.

Why is a section empty in the theme editor?

Choose its collection, product, blog or picture; until then shoppers do not see it.

Can I change the theme code?

Yes, but duplicate the theme first. Code changes are not covered by support; for larger changes we suggest a Shopify Partner.

Support policy

Live chat and support 24/7, every day of the week. The live chat on dartdesign.store and the support form answer around the clock; questions that need a person (refunds, complaints, custom work) are answered within two business days.

Support is included with your purchase. Write to us with the form on dartdesign.store/support and choose Pigment, or use the live chat there.

  • Included: help with the theme's settings and features, and fixes of problems in the theme.
  • Not included: custom design or code changes, help with third-party apps, and changes made to the theme's code by you or someone else.
  • Theme updates are free. Before updating a theme you have edited, duplicate it.

Release notes

Version 1.0.0

  • First release: color slideshow (dots with color names, pause button), Shop by color, product tabs, color stories, paint-chip collection list, Shop the look with Add the look to cart, a second featured collection, image with text, blog posts and email signup; fourteen palettes, 7 languages and right-to-left.