Create custom print classes with Tailwind CSS

Configure Tailwind to prefix classes with custom media queries for print stylesheets - learn how with this tutorial! #TailwindCSS #printstyles

  • Table of contents

custom media query tailwind

If you need to a @media print (print stylesheet) for your website and you use Tailwind you can customize the tailwind.config.js to include custom media queries.

Use Print stylesheets for printers and PDFs

The appearance of a website often differs when printed or saved as a PDF. For that reason it is useful to define CSS styles that only apply to printers or PDFs (or devices that satisfy the @media print media query).

Tailwind config extend media queries

Extend the standard tailwind config in a tailwind.config.js file itesting-email-with-cypressn your project root.

module.exports = {
    theme: {
        extend: {
            screens: {
                'print': { 'raw': 'print' },

This means we can use classes such as print:mb-4 to apply a margin to an element only for print styles.

Using custom classes

Here is an example using React. Notice the class names that have a print: prefix.

import React from "react";

const FeatureCard: React.FC<{
  name: string;
  icon?: any;
  text?: string;
  iconClass?: string;
}> = (props) => {
  return (
    <div key={} className={props.icon ? "pt-6" : ""}>
      <div className="flow-root print:bg-red-100 bg-gray-50 rounded-lg px-6 pb-8 print:p-0">
        <div className={props.icon ? "-mt-6" : ""}>
          <div className={"print:hidden"}>
            {props.icon ? (
                  "inline-flex items-center justify-center p-3 rounded-md shadow-lg  " +
                  (props.iconClass ?? "")
                  className="h-6 w-6 text-white transform hover:scale-110 transition duration-100"
            ) : undefined}
          <h3 className={"text-lg font-medium text-gray-900 mt-8 font-sans"}>
          {props.text ? (
            <p className="mt-3 text-sm text-gray-500">{props.text}</p>
          ) : undefined}
export default FeatureCard;


This is an example of how flexible Tailwind CSS can be. It lets you configure print styles using custom media queries so that you can use all the standard tailwind classes with a print: prefix to apply the rule's styles only when a print media query is satisfied.

In the screenshot below we can see a website with a print dialog above it showing the print and screen styles together. Notice the difference that was achieved using the tailwind css print media queries:

tailwind print stylesheets