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
- Single-accent voltagePinterest Red #e60023 reserved for Sign-up CTAs, active tabs, and the wordmark, never decorative
- Two-radius shape system16px on every button and pin card, 32px on modals and large pins, nothing in between
- Steep type jump70px Pin Sans display drops directly to 16px body with no intermediate tier on the home hero
- Masonry pin grid at 8px guttersimagery effectively touches across columns, the tightest grid in mainstream marketing
- 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.

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 Primarybutton-primaryButton Primary
- Button Primary Pressedbutton-primary-pressedButton Primary Pressed
- Button Secondarybutton-secondaryButton Secondary
- Button Secondary Pressedbutton-secondary-pressedButton Secondary Pressed
- Button Tertiarybutton-tertiaryButton Tertiary
- button-icon-circularButton Icon Circular
- Button Pill On Imagebutton-pill-on-imageButton Pill On Image
- Button Disabledbutton-disabledButton Disabled
- Search Barsearch-barSearch Bar
- Search Bar Focusedsearch-bar-focusedSearch Bar Focused
- Type here…text-inputText Input
- Type here…text-input-focusedText Input Focused
- Pin Cardpin-cardPin Card
- Pin Card Largepin-card-largePin Card Large
- Pin Overlay Pillpin-overlay-pillPin Overlay Pill
- Filter Chipfilter-chipFilter Chip
- Filter Chip Activefilter-chip-activeFilter Chip Active
- Category Tilecategory-tileCategory Tile
- Feature Cardfeature-cardFeature Card
- Feature Card Softfeature-card-softFeature Card Soft
- Modal Cardmodal-cardModal Card
- Hero Cta Striphero-cta-stripHero Cta Strip
- Primary Navprimary-navPrimary Nav
- Footer Sectionfooter-sectionFooter Section
- Link Inlinelink-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.
FAQ
Pinterest design system FAQ
Common questions about Pinterest's tokens, components, and how to use this DESIGN.md in your project.
Read next
Related reading
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 the DESIGN.md
One machine-readable file: every color, type, radius, spacing, and component token of Pinterest.
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.
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.
Billing
Billed once a year in USD. Cancel anytime.
- How many people can use the license.
- Client work, SaaS products and anything you charge for.
- Production-ready React sections: hero, pricing, features, dashboards and more.
- Complete multi-page sites you can ship as they are.
- React icons from every major library, installable with one command.
- Presets that restyle every block, in light and dark.
- Lets your AI editor search, preview and install blocks for you.
- Priority requests are answered first.
Individual
For personal projects & open source
$32instead of $49/mo
$389 billed yearly
- Seats: 1 seat
- Commercial use: Personal & open source only
- Pro blocks: 6,000+ blocks
- Templates: All 14 templates
- React icons: 294k+ icons
- Themes: All 59 themes
- MCP server: Basic usage
- Support: Standard
Team
Most popularFor freelancers, agencies & startups
$66instead of $99/mo
$789 billed yearly · ≈ $13/dev/mo
- Seats: Up to 5 seats
- Commercial use: Included
- Pro blocks: 6,000+ blocks
- Templates: All 14 templates
- React icons: 294k+ icons
- Themes: All 59 themes
- MCP server: High usage
- Support: Priority
Organization
For companies with larger teams
$132instead of $199/mo
$1,589 billed yearly
- Seats: Unlimited seats
- Commercial use: Included
- Pro blocks: 6,000+ blocks
- Templates: All 14 templates
- React icons: 294k+ icons
- Themes: All 59 themes
- MCP server: Unlimited usage
- Support: Priority
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 popularFor 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.