Skip to content

Pinterest Design System

Pinterest's design system as a DESIGN.md file. Pinterest Red #e60023, Pin Sans, 31 colors, 25 components. For React, Next.js, and AI tools.

Add shadcn.io to your AI agent. · Pro It installs blocks, icons and templates in your design system from a prompt, with Pro.

Set up MCP
Primary
#e60023
Typeface
Pin Sans
Shape
Soft
Base radius
16px
Colors
31
Type tokens
14
Components
25
Spacing values
8

About

About Pinterest DESIGN.md

Curated by Dov Azencot · Updated May 12, 2026 · Source pinterest.com (opens in a new tab)

Pinterest's marketing system is the discipline of getting out of the photograph's way. The chrome runs a warm-cream neutral palette — #fbfbf9 page wash, #f6f6f3 card surface, true #ffffff canvas — with Pin Sans typography in tight negative-tracked display sizes, and a single saturated Pinterest Red (#e60023) reserved exclusively for the Sign-up CTA, the active-tab indicator, and the brand wordmark. The home page alternates two surface modes: hero/CTA chrome with 70px display headlines and alternating left/right feature cards, then a column-based masonry pin grid where each tile is a 16px-radius card at its natural aspect ratio with 8px gutters between columns.

This page packages all of that into a single DESIGN.md file written to the Google Labs open specification. Inside: 31 colors tokens grouped into brand, surface, text, semantic, and editorial-accent buckets; 14 Pin Sans typography roles from 70px display-xl down to 12px caption-sm; five border-radius values where only three see active use (16px, 32px, pill); a nine-step 8px-based spacing scale; and 25 components covering buttons, filter chips, search bar, pin cards, modal, primary nav, and footer. Each component declares its background, text color, typography, radius, and padding by referencing tokens — every value resolves back to a quoted hex or pixel literal.

Feed the file to Claude, Cursor, or GitHub Copilot and the agent reproduces Pinterest's restraint — the single red accent, the warm-cream surfaces, the masonry pin grid, the two-radius shape vocabulary — rather than inventing a generic photography theme. Reference tokens directly in Tailwind config or CSS variables when you want one specific value. The system is worth studying because it commits hard to one rule most photo-led brands hedge on: type and chrome serve the imagery, never compete with it.

What makes it distinct

5

  1. Single-accent voltagePinterest Red #e60023 reserved for Sign-up CTAs, active tabs, and the wordmark, never decorative
  2. Two-radius shape system16px on every button and pin card, 32px on modals and large pins, nothing in between
  3. Steep type jump70px Pin Sans display drops directly to 16px body with no intermediate tier on the home hero
  4. Masonry pin grid at 8px guttersimagery effectively touches across columns, the tightest grid in mainstream marketing
  5. Warm-cream chrome#f6f6f3 card surface and #fbfbf9 page wash recede behind photography without competing

pinterest.com

Live at pinterest.com

A snapshot of the brand in production. Scroll the frame to see the whole page.

Pinterest's website at pinterest.com

Colors

31 colors

Pinterest's system runs on #e60023 as its primary voltage, used in 1 of 25 components. Type is set in Pin Sans across 14 tokens from 12px to 70px, weights 400–700. Shape language is soft — components average 15px corner radius, with no sharp interactive edges.

Brand & Accent

Sparing, CTA-only voltage · 5

Surface

Page and card backgrounds · 5

Text

Headlines, body, captions · 7

Borders & Hairlines

Dividers, outlines, rules · 2

Semantic

Status, errors, success, links · 4

Other

Specialty colors · 8

Typography

14 type tokens

Set in Pin Sans across 14 tokens, from 12px to 70px, weights 400–700. Shown in its own stack: where the font isn't installed, the fallback the file names stands in.

  • display-xl70px · weight 600 · lh 1.1 · tracking -1.2pxThe quick brown fox jumps over the lazy dog
  • display-lg44px · weight 700 · lh 1.15 · tracking -0.8pxThe quick brown fox jumps over the lazy dog
  • heading-xl28px · weight 700 · lh 1.2 · tracking -1.2pxThe quick brown fox jumps over the lazy dog
  • heading-lg22px · weight 600 · lh 1.25The quick brown fox jumps over the lazy dog
  • heading-md18px · weight 600 · lh 1.3The quick brown fox jumps over the lazy dog
  • body-md16px · weight 400 · lh 1.4The quick brown fox jumps over the lazy dog
  • body-strong16px · weight 600 · lh 1.4The quick brown fox jumps over the lazy dog
  • body-sm14px · weight 400 · lh 1.4The quick brown fox jumps over the lazy dog
  • body-sm-strong14px · weight 700 · lh 1.4The quick brown fox jumps over the lazy dog
  • caption-md12px · weight 500 · lh 1.5The quick brown fox jumps over the lazy dog
  • caption-sm12px · weight 400 · lh 1.4The quick brown fox jumps over the lazy dog
  • link-md16px · weight 600 · lh 1.4The quick brown fox jumps over the lazy dog
  • button-md14px · weight 700 · lh 1The quick brown fox jumps over the lazy dog
  • button-sm12px · weight 700 · lh 1The quick brown fox jumps over the lazy dog

Layout

Radii and spacing

5 corner radii and 8 spacing values. Shape language: soft.

Radii

  • none0px
  • sm8px
  • md16px
  • lg32px
  • full9999px

Spacing

  • xxs4px
  • xs6px
  • sm8px
  • md12px
  • lg16px
  • xl24px
  • xxl32px
  • section64px

Components

25 components

Each rendered from its tokens (color, type, radius, padding) on Pinterest's own canvas.

  • Button Primary
    button-primaryButton Primary
  • Button Primary Pressed
    button-primary-pressedButton Primary Pressed
  • Button Secondary
    button-secondaryButton Secondary
  • Button Secondary Pressed
    button-secondary-pressedButton Secondary Pressed
  • Button Tertiary
    button-tertiaryButton Tertiary
  • button-icon-circularButton Icon Circular
  • Button Pill On Image
    button-pill-on-imageButton Pill On Image
  • Button Disabled
    button-disabledButton Disabled
  • Search Bar
    search-barSearch Bar
  • Search Bar Focused
    search-bar-focusedSearch Bar Focused
  • Type here…
    text-inputText Input
  • Type here…
    text-input-focusedText Input Focused
  • Pin Card
    pin-cardPin Card
  • Pin Card Large
    pin-card-largePin Card Large
  • Pin Overlay Pill
    pin-overlay-pillPin Overlay Pill
  • Filter Chip
    filter-chipFilter Chip
  • Filter Chip Active
    filter-chip-activeFilter Chip Active
  • Category Tile
    category-tileCategory Tile
  • Feature Card
    feature-cardFeature Card
  • Feature Card Soft
    feature-card-softFeature Card Soft
  • Modal Card
    modal-cardModal Card
  • Hero Cta Strip
    hero-cta-stripHero Cta Strip
  • Primary Nav
    primary-navPrimary Nav
  • Footer Section
    footer-sectionFooter Section
  • Link Inline
    link-inlineLink Inline

In use

The system, in use

Pinterest's tokens on the kind of product it builds.

Build something people actually use.

A short paragraph of marketing copy that previews how the brand's display tier and body tier read together. Two sentences is usually enough.

Get startedLearn more
Marketing heroHeadline, sub-copy, primary CTA — the universal homepage opener.

FAQ

Pinterest design system FAQ

Common questions about Pinterest's tokens, components, and how to use this DESIGN.md in your project.

Read next

Specs, directories, and component libraries that pair with this design system.

Use it

Use Pinterest in your project

One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.

Download DESIGN.md
  1. Download the DESIGN.md

    One machine-readable file: every color, type, radius, spacing, and component token of Pinterest.

  2. Feed it to your AI tool

    Drop it into Claude, Cursor, or GitHub Copilot. The agent writes React components and Tailwind classes that match Pinterest's visual language.

  3. Reference the tokens directly

    Or paste the values into your Tailwind config, CSS variables, or component library: every color, size and radius is a quoted, ready-to-copy value.

Read the full DESIGN.md: overview, rationale, do’s and don’ts

Overview

Pinterest's marketing system is built around a single instructional principle: get out of the photograph's way. The chrome is a quiet warm-cream neutral palette (#fbfbf9, #f6f6f3, #ffffff) carrying typography in Pinterest's proprietary Pin Sans face, with Pinterest Red (#e60023) reserved exclusively for the "Sign up" CTA, the active-tab indicator, and the sticky top-nav anchor. Every other surface is allowed to fade behind the imagery — pin tiles, category tiles, content thumbnails, profile shots — that constitutes the actual product.

The design system has two distinct surface modes that alternate down the home page: the hero/CTA chrome (cream surfaces, large 70px Pin Sans display headlines, alternating left/right photo-illustrated feature cards) and the content masonry (a column-based grid of 16px-radius pin cards on #f6f6f3 with no internal padding — the pin is the card). The search results page is almost pure masonry: a tight column grid of pin imagery in mixed aspect ratios, with a small filter-chip strip at the top and the sticky red Sign-up CTA in the upper-right corner. The create.pinterest.com business surface inverts the grid back to a more traditional editorial layout but keeps every other rule of the system: Pin Sans, cream chrome, red CTA, 16px-radius pills.

The system's signature gesture is shape geometry: 16px radius for nearly every surface — buttons, inputs, pin cards, feature cards — and 32px radius reserved for pin-card-large and modal cards. There are exactly three radius values in active use: 16px, 32px, and pill (9999px). The system never goes flat (sharp corners) and never goes radius-medium — those two values are the entire shape vocabulary.

Key Characteristics:

  • Single-accent CTA: Pinterest Red #e60023 carries every primary action; everything else is monochrome
  • Pin Sans proprietary typography across every text role from 70px display-xl down to 12px caption-sm — no serif, no monospace anywhere
  • Two-radius shape system: 16px for most components, 32px for large cards and modals, pill for circular elements
  • Masonry pin grid as the load-bearing visual element — column-based layout where each pin's natural aspect ratio is preserved
  • Warm-cream neutral chrome (#f6f6f3) that softly recedes behind imagery without competing
  • Sticky top nav with the always-red Sign-up CTA anchored in the upper-right at every breakpoint
  • Modal overlay (login/signup) using a soft scrim over the page content rather than a navigation jump

Known Gaps

  • Mobile screenshots not captured — responsive behavior synthesizes Pinterest's known mobile pattern (hamburger drawer, single-column grid, hero downscale) from desktop evidence and the documented breakpoint stack.
  • Hover states not documented by system policy.
  • Pin-detail close-up (single pin overlay) is not in the captured set — the in-product Pin detail view (with comments, related pins, save board picker) likely introduces components not documented here.
  • Authenticated chrome (logged-in home feed, board pages, profile pages) not in the captured pages — the captured surfaces are the logged-out marketing and search experience.
  • Pinterest mobile app screens not in the system documented here — this is the web-only chrome.
  • Form validation states (success / error inline messages) not documented; only the focused-state field is captured.

Social & Community

More systems like this

More DESIGN.md files in Social & Community.

Pricing

Build it with Pro

The DESIGN.md files are free. Pro adds 6,000+ blocks, premium templates and the MCP server, so your AI editor builds in your system for you.

4.9/5 out of 5 · 150+ reviewsfrom 150+ founders and developers.

Billed once a year in USD. Cancel anytime.

Individual

For personal projects & open source

$32instead of $49/mo

$389 billed yearly

  • How many people can use the license.Seats: 1 seat
  • Client work, SaaS products and anything you charge for.Commercial use: Personal & open source only
  • Production-ready React sections: hero, pricing, features, dashboards and more.Pro blocks: 6,000+ blocks
  • Complete multi-page sites you can ship as they are.Templates: All 14 templates
  • React icons from every major library, installable with one command.React icons: 294k+ icons
  • Presets that restyle every block, in light and dark.Themes: All 59 themes
  • Lets your AI editor search, preview and install blocks for you.MCP server: Basic usage
  • Priority requests are answered first.Support: Standard

Team

Most popular

For freelancers, agencies & startups

$66instead of $99/mo

$789 billed yearly · ≈ $13/dev/mo

Everything in Individual, plus

  • How many people can use the license.Seats: Up to 5 seats
  • Client work, SaaS products and anything you charge for.Commercial use: Included
  • Lets your AI editor search, preview and install blocks for you.MCP server: High usage
  • Priority requests are answered first.Support: Priority

Organization

For companies with larger teams

$132instead of $199/mo

$1,589 billed yearly

Everything in Team, plus

  • How many people can use the license.Seats: Unlimited seats
  • Lets your AI editor search, preview and install blocks for you.MCP server: Unlimited usage
  • Secure checkout via Stripe
  • Code lives in your repo
  • Keep what you've shipped if you cancel
  • License terms

Your system, built for you

Every block, template and icon, installed by your AI agent in your design system. The DESIGN.md files stay free.

Get Pro