Customization

Customizing Colors

Customizing the default color palette for your project.

Default color palette

Tailwind includes an expertly-crafted default color palette out-of-the-box that is a great starting point if you don’t have your own specific branding in mind.

Slate

50

f8fafc

100

f1f5f9

200

e2e8f0

300

cbd5e1

400

94a3b8

500

64748b

600

475569

700

334155

800

1e293b

900

0f172a

950

020617

Gray

50

f9fafb

100

f3f4f6

200

e5e7eb

300

d1d5db

400

9ca3af

500

6b7280

600

4b5563

700

374151

800

1f2937

900

111827

950

030712

Zinc

50

fafafa

100

f4f4f5

200

e4e4e7

300

d4d4d8

400

a1a1aa

500

71717a

600

52525b

700

3f3f46

800

27272a

900

18181b

950

09090b

Neutral

50

fafafa

100

f5f5f5

200

e5e5e5

300

d4d4d4

400

a3a3a3

500

737373

600

525252

700

404040

800

262626

900

171717

950

0a0a0a

Stone

50

fafaf9

100

f5f5f4

200

e7e5e4

300

d6d3d1

400

a8a29e

500

78716c

600

57534e

700

44403c

800

292524

900

1c1917

950

0c0a09

Red

50

fef2f2

100

fee2e2

200

fecaca

300

fca5a5

400

f87171

500

ef4444

600

dc2626

700

b91c1c

800

991b1b

900

7f1d1d

950

450a0a

Orange

50

fff7ed

100

ffedd5

200

fed7aa

300

fdba74

400

fb923c

500

f97316

600

ea580c

700

c2410c

800

9a3412

900

7c2d12

950

431407

Amber

50

fffbeb

100

fef3c7

200

fde68a

300

fcd34d

400

fbbf24

500

f59e0b

600

d97706

700

b45309

800

92400e

900

78350f

950

451a03

Yellow

50

fefce8

100

fef9c3

200

fef08a

300

fde047

400

facc15

500

eab308

600

ca8a04

700

a16207

800

854d0e

900

713f12

950

422006

Lime

50

f7fee7

100

ecfccb

200

d9f99d

300

bef264

400

a3e635

500

84cc16

600

65a30d

700

4d7c0f

800

3f6212

900

365314

950

1a2e05

Green

50

f0fdf4

100

dcfce7

200

bbf7d0

300

86efac

400

4ade80

500

22c55e

600

16a34a

700

15803d

800

166534

900

14532d

950

052e16

Emerald

50

ecfdf5

100

d1fae5

200

a7f3d0

300

6ee7b7

400

34d399

500

10b981

600

059669

700

047857

800

065f46

900

064e3b

950

022c22

Teal

50

f0fdfa

100

ccfbf1

200

99f6e4

300

5eead4

400

2dd4bf

500

14b8a6

600

0d9488

700

0f766e

800

115e59

900

134e4a

950

042f2e

Cyan

50

ecfeff

100

cffafe

200

a5f3fc

300

67e8f9

400

22d3ee

500

06b6d4

600

0891b2

700

0e7490

800

155e75

900

164e63

950

083344

Sky

50

f0f9ff

100

e0f2fe

200

bae6fd

300

7dd3fc

400

38bdf8

500

0ea5e9

600

0284c7

700

0369a1

800

075985

900

0c4a6e

950

082f49

Blue

50

eff6ff

100

dbeafe

200

bfdbfe

300

93c5fd

400

60a5fa

500

3b82f6

600

2563eb

700

1d4ed8

800

1e40af

900

1e3a8a

950

172554

Indigo

50

eef2ff

100

e0e7ff

200

c7d2fe

300

a5b4fc

400

818cf8

500

6366f1

600

4f46e5

700

4338ca

800

3730a3

900

312e81

950

1e1b4b

Violet

50

f5f3ff

100

ede9fe

200

ddd6fe

300

c4b5fd

400

a78bfa

500

8b5cf6

600

7c3aed

700

6d28d9

800

5b21b6

900

4c1d95

950

2e1065

Purple

50

faf5ff

100

f3e8ff

200

e9d5ff

300

d8b4fe

400

c084fc

500

a855f7

600

9333ea

700

7e22ce

800

6b21a8

900

581c87

950

3b0764

Fuchsia

50

fdf4ff

100

fae8ff

200

f5d0fe

300

f0abfc

400

e879f9

500

d946ef

600

c026d3

700

a21caf

800

86198f

900

701a75

950

4a044e

Pink

50

fdf2f8

100

fce7f3

200

fbcfe8

300

f9a8d4

400

f472b6

500

ec4899

600

db2777

700

be185d

800

9d174d

900

831843

950

500724

Rose

50

fff1f2

100

ffe4e6

200

fecdd3

300

fda4af

400

fb7185

500

f43f5e

600

e11d48

700

be123c

800

9f1239

900

881337

950

4c0519

But when you do need to customize your palette, you can configure your colors under the colors key in the theme section of your tailwind.config.js file:

tailwind.config.js

module.exports = {
  theme: {
    colors: {
      // Configure your color palette here
    }
  }
}

When it comes to building a custom color palette, you can either configure your own custom colors from scratch if you know exactly what you want, or curate your colors from our extensive included color palette if you want a head start.

Using custom colors

If you’d like to completely replace the default color palette with your own custom colors, add your colors directly under the theme.colors section of your configuration file:

tailwind.config.js

module.exports = {
  theme: {
    colors: {
      transparent: 'transparent',
      current: 'currentColor',
      'white': '#ffffff',
      'purple': '#3f3cbb',
      'midnight': '#121063',
      'metal': '#565584',
      'tahiti': '#3ab7bf',
      'silver': '#ecebff',
      'bubble-gum': '#ff77e9',
      'bermuda': '#78dcca',
    },
  },
}

By default, these colors will be made available everywhere in the framework where you use colors, like the text color utilities, border color utilities, background color utilities, and more.

<div class="bg-midnight text-tahiti">
  <!-- ... -->
</div>

Don’t forget to include values like transparent and currentColor if you want to use them in your project.

Color object syntax

When your palette includes multiple shades of the same color, it can be convenient to group them together using our nested color object syntax:

tailwind.config.js

module.exports = {
  theme: {
    colors: {
      transparent: 'transparent',
      current: 'currentColor',
      'white': '#ffffff',
      'tahiti': {
        100: '#cffafe',
        200: '#a5f3fc',
        300: '#67e8f9',
        400: '#22d3ee',
        500: '#06b6d4',
        600: '#0891b2',
        700: '#0e7490',
        800: '#155e75',
        900: '#164e63',
      },
      // ...
    },
  },
}

The nested keys will be combined with the parent key to form class names like bg-tahiti-400.

Like many other places in Tailwind, the special DEFAULT key can be used when you want to define a value with no suffix:

tailwind.config.js

module.exports = {
  theme: {
    colors: {
      // ...
      'tahiti': {
        light: '#67e8f9',
        DEFAULT: '#06b6d4',
        dark: '#0e7490',
      },
      // ...
    },
  },
}

This will create classes like bg-tahiti, bg-tahiti-light, and bg-tahiti-dark.

Arbitrary values

If you need a one-off custom color in your project, consider using Tailwind’s arbitrary value notation to generate a class for that color on-demand instead of adding it to your theme:

<button class="bg-[#1da1f2] text-white ...">
  <svg><!-- ... --></svg>
  Share on Twitter
</button>

Learn more in the using arbitrary values documentation.

Generating colors

If you’re wondering how to automatically generate the 50–950 shades of your own custom colors, bad news — color is complicated and despite trying dozens of different tools, we’ve yet to find one that does a good job generating color palettes like this automatically.

We picked all of Tailwind’s default colors by hand, meticulously balancing them by eye and testing them in real designs to make sure we were happy with them.

Two useful tools we can recommend are Palettte and ColorBox — they won’t do the work for you but their interfaces are well-designed for doing this sort of work.

Using the default colors

If you don’t have a set of completely custom colors in mind for your project, you can curate your colors from our default palette by importing tailwindcss/colors in your configuration file and choosing the colors you want to use:

tailwind.config.js

const colors = require('tailwindcss/colors')
module.exports = {
  theme: {
    colors: {
      transparent: 'transparent',
      current: 'currentColor',
      black: colors.black,
      white: colors.white,
      gray: colors.gray,
      emerald: colors.emerald,
      indigo: colors.indigo,
      yellow: colors.yellow,
    },
  },
}

This can be helpful if you want to deliberately limit your color palette and reduce the number of class names suggested by IntelliSense.

Aliasing color names

You can also alias the colors in our default palette to make the names simpler and easier to remember:

tailwind.config.js

const colors = require('tailwindcss/colors')
module.exports = {
  theme: {
    colors: {
      transparent: 'transparent',
      current: 'currentColor',
      black: colors.black,
      white: colors.white,
      gray: colors.slate,
      green: colors.emerald,
      purple: colors.violet,
      yellow: colors.amber,
      pink: colors.fuchsia,
    },
  },
}

This is especially common for grays, as you usually only use one set in any given project and it’s nice to be able to type bg-gray-300 instead of bg-neutral-300 for example.

Adding additional colors

If you’d like to add a brand new color to the default palette, add it in the theme.extend.colors section of your configuration file:

tailwind.config.js

module.exports = {
  theme: {
    extend: {
      colors: {
        brown: {
          50: '#fdf8f6',
          100: '#f2e8e5',
          200: '#eaddd7',
          300: '#e0cec7',
          400: '#d2bab0',
          500: '#bfa094',
          600: '#a18072',
          700: '#977669',
          800: '#846358',
          900: '#43302b',
        },
      }
    },
  },
}

You can also use theme.extend.colors to add additional shades to an existing color if it’s needed for your design:

tailwind.config.js

module.exports = {
  theme: {
    extend: {
      colors: {
        blue: {
          950: '#17275c',
        },
      }
    },
  },
}

Disabling a default color

If you’d like to disable any of the default colors, the best approach is to override the default color palette and just include the colors you do want:

tailwind.config.js

const colors = require('tailwindcss/colors')
module.exports = {
  theme: {
    colors: {
      transparent: 'transparent',
      current: 'currentColor',
      black: colors.black,
      white: colors.white,
      gray: colors.gray,
      emerald: colors.emerald,
      indigo: colors.indigo,
      yellow: colors.yellow,
    },
  },
}

Naming your colors

Tailwind uses literal color names (like red, green, etc.) and a numeric scale (where 50 is light and 900 is dark) by default. We think this is the best choice for most projects, and have found it easier to maintain than using abstract names like primary or danger.

That said, you can name your colors in Tailwind whatever you like, and if you’re working on a project that needs to support multiple themes for example, it might make sense to use more abstract names:

tailwind.config.js

module.exports = {
  theme: {
    colors: {
      primary: '#5c6ac4',
      secondary: '#ecc94b',
      // ...
    }
  }
}

You can configure those colors explicitly like we have above, or you can pull in colors from our default color palette and alias them:

tailwind.config.js

const colors = require('tailwindcss/colors')
module.exports = {
  theme: {
    colors: {
      primary: colors.indigo,
      secondary: colors.yellow,
      neutral: colors.gray,
    }
  }
}

Again, we recommend sticking to the default naming convention for most projects, and only using abstract names if you have a really good reason.

Using CSS variables

If you’d like to define your colors as CSS variables, you’ll need to define those variables as just the color channels if you want them to work with the opacity modifier syntax:

Define your CSS variables as channels with no color space function

main.css

@tailwind base;
@tailwind components;
@tailwind utilities;
@layer base {
  :root {
    --color-primary: 255 115 179;
    --color-secondary: 111 114 185;
    /* ... */
  }
}

Don’t include the color space function or opacity modifiers won’t work

main.css

@tailwind base;
@tailwind components;
@tailwind utilities;
@layer base {
  :root {
    --color-primary: rgb(255 115 179);
    --color-secondary: rgb(111 114 185);
    /* ... */
  }
}

Then define your colors in your configuration file, being sure to include the color space you’re using, and the special <alpha-value> placeholder that Tailwind will use to inject the alpha value when using an opacity modifier:

tailwind.config.js

module.exports = {
  theme: {
    colors: {
      // Using modern `rgb`
      primary: 'rgb(var(--color-primary) / <alpha-value>)',
      secondary: 'rgb(var(--color-secondary) / <alpha-value>)',
      // Using modern `hsl`
      primary: 'hsl(var(--color-primary) / <alpha-value>)',
      secondary: 'hsl(var(--color-secondary) / <alpha-value>)',
      // Using legacy `rgba`
      primary: 'rgba(var(--color-primary), <alpha-value>)',
      secondary: 'rgba(var(--color-secondary), <alpha-value>)',
    }
  }
}

When defining your colors this way, make sure that the format of your CSS variables is correct for the color function you are using. You’ll want to use spaces if using the modern space-separated syntax, and commas if using legacy functions like rgba or hsla:

main.css

@tailwind base;
@tailwind components;
@tailwind utilities;
@layer base {
  :root {
    /* For rgb(255 115 179 / <alpha-value>) */
    --color-primary: 255 115 179;
    /* For hsl(198deg 93% 60% / <alpha-value>) */
    --color-primary: 198deg 93% 60%;
    /* For rgba(255, 115, 179, <alpha-value>) */
    --color-primary: 255, 115, 179;
  }
}