gem-hunter

Print the content of a React component.

npm install --save react-to-print

import { useReactToPrint } from "react-to-print";
import { useRef } from "react";

const contentRef = useRef<HTMLDivElement>(null);
const reactToPrintFn = useReactToPrint({ contentRef });

return (
  <div>
    <button onClick={reactToPrintFn}>Print</button>
    <div ref={contentRef}>Content to print</div>
  </div>
);

It is also possible to lazy set the ref if your content being printed is dynamic. See the LazyContent example for more. This can also be useful for setting the ref in non-React code, such as util functions.

react-to-print should be compatible with most modern browsers.

While printing on mobile browsers generally works, printing within a WebView (when your page is opened by an app such as Facebook or Slack, but not by the full browser itself) is known to generally not work. Some WebViews don't make the correct API available. Others make it available but cause printing to no-op.

We are actively researching resolutions to this issue, but it likely requires changes by Google/Chromium and Apple/WebKit. See #384 for more information. If you know of a way we can solve this your help would be greatly appreciated.

• Firefox Android (does not support window.print)

• Some mobile browser may, instead of printing, open the native Share action instead
• onAfterPrint may fire immediately (before the print dialog is closed) on newer versions of Safari where window.print does not block
• (401): TypeScript errors such as Type 'undefined' is not assignable to type 'ReactInstance | null'.. You likely need to set your ref to initially be null: useRef(null)

• documentTitle will not work if react-to-print is run within an iframe. If react-to-print is run within an iframe and your script has access to the parent document, you may be able to manually set and then restore the parent document's title during the print. This can be done by leveraging the onBeforePrint and onAfterPrint callbacks.

• When printing, only styles that directly target the printed nodes will be applied as the parent nodes of the printed nodes will not exist in the print DOM. For example, in the code below, if the <p> tag is the root of the ComponentToPrint then the red styling will not be applied. Be sure to target all printed content directly and not from unprinted parents.

  <div className="parent">
    <p>Hello</p>
  </div>

  div.parent p { color:red; }

• The connect method from react-redux returns a functional component that cannot be assigned a reference to be used within the contentRef. To use a component wrapped in connect within contentRef, create an intermediate component that simply renders your component wrapped in connect. See 280 for more.

• When rendering multiple components to print, ensure each is passed a unique ref. Then, either use a unique useReactToPrint call for each component, or, using a single useReactToPrint call pass the refs at print-time to the printing function returned by the hook. If you share refs across components only the last component will be printed. See 323 for more.

You can pass a function to documentTitle that returns a string. This function will be evaluated at print time, allowing you to include dynamic data like timestamps or user information.

const printFn = useReactToPrint({
  contentRef: componentRef,
  documentTitle: () => `Invoice_${new Date().toISOString().split('T')[0]}`,
});

This will generate filenames like Invoice_2026-02-03.pdf with the current date when printing.

The simplest way to hide or show content during printing is to use a CSS Media Query.

.printContent {
  display: none;

  @media print {
    display: block;
  }
}

const contentRef = useRef<HTMLDivElement>(null);
const reactToPrintFn = useReactToPrint({ contentRef });

return (
  <div>
    <button onClick={reactToPrintFn}>Print</button>
    <div className="printContent" ref={contentRef}>Content to print</div>
  </div>
);

Not directly. We aren't able to print a PDF as we lose control once the print preview window opens. However, it is possible to use react-to-print to gather the content you want to print and pass it to a library that can generate a PDF.

const handlePrint = useReactToPrint({
  ...,
  print: async (printIframe: HTMLIframeElement) => {
    // Do whatever you want here, including asynchronous work
    await generateAndSavePDF(printIframe);
  },
});

For examples of how others have done this, see #484

No. The window.print API does not provide a way to change these settings. Only various CSS hints can be provided, with each browser potentially treating them differently.

Not directly. To print a Class based component you will need to manually forward the contentRef as a prop:

class ComponentToPrint extends Component {
  render() {
    return (
      <div ref={this.props.innerRef}>
        Print content
      </div>
    )
  }
}

function App {
  const contentRef = useRef(null);
  const handlePrint = useReactToPrint({ contentRef });

  return (
    <div>
      <button onClick={handlePrint}>Print</button>
      <ComponentToPrint innerRef={contentRef} />
    </div>
  );
}

onAfterPrint fires when the print dialog closes, regardless of why it closes. This is the behavior of the onafterprint browser event.

<link>s with empty href attributes are invalid HTML. In addition, they can cause all sorts of undesirable behavior. For example, many browsers - including modern ones, when presented with <link href=""> will attempt to load the current page. Some even attempt to load the current page's parent directory.

Note: related to the above, img tags with empty src attributes are also invalid, and we may not attempt to load them.

If you've created a component that is intended only for printing and should not render in the parent component, wrap that component in a div with style set to { display: "none" }, like so:

<div style={{ display: "none" }}><ComponentToPrint ref={componentRef} /></div>

This will hide ComponentToPrint but keep it in the DOM so that it can be copied for printing.

Recall that setting state is asynchronous. As such, you need to pass a Promise and wait for the state to update.

const [isPrinting, setIsPrinting] = useState(false);
const contentRef = useRef(null);

// We store the resolve Promise being used in `onBeforePrint` here
const promiseResolveRef = useRef(null);

// We watch for the state to change here, and for the Promise resolve to be available
useEffect(() => {
  if (isPrinting && promiseResolveRef.current) {
    // Resolves the Promise, letting `react-to-print` know that the DOM updates are completed
    promiseResolveRef.current();
  }
}, [isPrinting]);

const handlePrint = useReactToPrint({
  contentRef,
  onBeforePrint: () => {
    return new Promise((resolve) => {
      promiseResolveRef.current = resolve;
      setIsPrinting(true);
    });
  },
  onAfterPrint: () => {
    // Reset the Promise resolve so we can print again
    promiseResolveRef.current = null;
    setIsPrinting(false);
  }
});

Note: for Class components, pass the Promise resolve to the callback for this.setState: this.setState({ isPrinting: false }, resolve)

Unfortunately there is no standard browser API for interacting with the print dialog. All react-to-print is able to do is open the dialog and give it the desired content to print. We cannot modify settings such as the default paper size, if the user has background graphics selected or not, etc.

react-to-print tries to wait for video elements to load before printing but a large part of this is up to the browser. Further, the image displayed will usually be the first frame of the video, which might not be what you expect to show. To ensure the proper image is displayed in the print we highly recommend setting the poster attribute of the video, which allows specifying an image to be a placeholder for the video until the video loads.

react-to-print can be used for printing in Electron, but you will need to provide your own print method since Electron does not natively support the window.print method. Please see this answer on StackOverflow for how to do this.

There is a fully-working example of how to use react-to-print with Electron available here.

Stylesheets linked with media="screen" apply only to screens, so their styles will not apply when printing. If a stylesheet should apply both on screen and when printing, explicitly set media="all" on its <link> element. For stylesheets meant to apply only when printing, set media="print". Check the rendered <link> elements if your framework sets the media attribute automatically.

While you should be able to place these styles anywhere, sometimes the browser doesn't always pick them up. To force orientation of the page you can include the following in the component being printed:

<style type="text/css" media="print">{"\
  @page {\ size: landscape;\ }\
"}</style>

The default page size is usually A4. Most browsers do not allow JavaScript or CSS to set the page size. For the browsers that do, it is usually done using the CSS page size property. Check caniuse to see if the browsers you develop against support this.

@media print {
  @page {
    size: 50mm 150mm;
  }
}

To set custom margin to the page,

First, create a function to return the page margin,

const getPageMargins = () => {
  return `@page { margin: ${marginTop} ${marginRight} ${marginBottom} ${marginLeft} !important; }`;
};

Now, within the JSX call this function within the style tags,

<style>{getPageMargins()}</style>

PS: This style tag should be inside the component that is being passed in as the content ref.

In the component that is passed in as the content ref, add the following:

@media print {
  @page { size: landscape; }
}

Instead of using { display: 'none'; }, try using { overflow: hidden; height: 0; }

pageStyle should be a CSS string. For example: ".divider { break-after: always; }"

Many have found setting the following CSS helpful. See #26 for more.

@media print {
  html, body {
    height: 100vh; /* Use 100% here to support printing more than a single page*/
    margin: 0 !important;
    padding: 0 !important;
    overflow: hidden;
  }
}

Another thing to try, especially if you are seeing this issue on mobile browsers, is to set preserveAfterPrint: true as it's possible the browser is causing the print iframe to be removed before printing has completed.

We often (#327, #343, #382) see issues reported where the developer is using Bootstrap or a similar grid system, and everything works great until the user goes to print and suddenly it seems the styles are off. We've found that often the issue is the grid library uses the smallest sized columns during printing, such as the xs size on Bootstrap's grid, a size developers often don't plan for. The simplest solution is to ensure your grid will adapt to this size appropriately, though this may not be acceptable since you may want the large view to print rather than the smaller view. Another solution is to override the grid column definition. Some newer versions of libraries have specific tools for dealing with printing, for example, Bootstrap 4's Display property.

The print iframe is a fresh document, so it picks up the user's/system prefers-color-scheme rather than whatever theme your app had applied at print time. If your styles are driven by @media (prefers-color-scheme: dark), the print output reflects the system preference, which may not match what was on screen.

react-to-print does enable printing of background colors by default (via print-color-adjust: exact), but it cannot know which theme you intended to print. To force a specific theme in the print output, target @media print explicitly and set your colors there rather than relying on prefers-color-scheme:

@media print {
  .my-content {
    background: #fff;
    color: #000;
  }
}

If you instead want the dark theme to print, set the dark colors inside @media print and remember background colors only print when print-color-adjust: exact is set (which react-to-print applies by default unless you override pageStyle).

Tailwind works with react-to-print, but two things commonly trip people up:

• Global styles must be reachable. react-to-print copies <style> and <link rel="stylesheet"> tags from the main document's <head>. Ensure your Tailwind stylesheet is loaded there and that you have not set ignoreGlobalStyles: true.
• Print-only utilities use the print: variant. Tailwind ships a print variant for print-specific styling, e.g. class="hidden print:block". Use it the same way you would @media print.

If only some styles are missing, confirm they target the printed nodes directly — see the note under Common Pitfalls about styles on unprinted parent elements not being applied.

If text or other content at the bottom of a page is cut off rather than flowing onto the next page, the usual culprit is a containing style that prevents the browser from paginating. Common offenders:

• overflow: hidden/overflow: scroll on a container — clips content instead of breaking it across pages. Use overflow: visible for print.
• A fixed height (e.g. height: 100vh) on html/body or a wrapper — constrains content to a single page. Prefer height: auto/initial for print.
• position: absolute or display: flex on wrappers can interfere with pagination; try display: block for print.

@media print {
  html, body {
    height: auto !important;
    overflow: visible !important;
  }
}

See also the Page Breaks section below for controlling where content breaks.

What to know:

• break-inside (replaces page-break-inside)
• break-before (replaces page-break-before)
• break-after (replaces page-break-after)

Define a page-break class to apply to elements which could be sensibly split into a page.

<div className="print-container" style={{ margin: "0", padding: "0" }}>
  {listOfContent.map(yourContent => (
    <>
      <div className="page-break" />
      <div>{yourContent}</div>
    </>
  ))}
</div>

In your styles, define your @media print styles, which should include setting your preference for CSS page-break- (see w3's reference for options) to auto, and ensuring that your page-break element does not affect non-print styles.

@media all {
  .page-break {
    display: none;
  }
}

@media print {
  html, body {
    height: initial !important;
    overflow: initial !important;
    -webkit-print-color-adjust: exact;
  }
}

@media print {
  .page-break {
    margin-top: 1rem;
    display: block;
    page-break-before: auto;
  }
}

@page {
  size: auto;
  margin: 20mm;
}

If your content rendered as print media does not automatically break multi-page content into multiple pages, the issue may be

• Style incompatibilities with print media rendering
• A need to assign CSS page-break- properties to define how your document should behave when printed

• A style of overflow: scroll, when rendered to print, will result in cut off content instead of page breaks to include the content
• A style of position: absolute, when rendered to print, may result in reformatted, rotated, or re-scaled content, causing unintended affects to print page layout and page breaks
• Using flex may interfere with page breaks, try using display: block

If you need to print the content of a scrolling container, you may encounter the following issues:

• Unable to control the scroll position, so the printed content may not be what you want.
• Overflow content is truncated, resulting in missing printed content.

To solve these problems, you need to modify the properties of the scrolling container when printing. You can pass a function to the print property, which will be called when printing. In this function, you can use the DOM API to query the scrolling container that needs to be modified, and then modify its properties to control the scroll position.

const customToPrint = (printWindow) => {
  const printContent = printWindow.contentDocument || printWindow.contentWindow?.document;
  const printedScrollContainer = printContent.querySelector('.scroll-container');

  const originScrollContainer = document.querySelector('.scroll-container');

  // Set the scroll position of the printed container to match the origin container
  printedScrollContainer.scrollTop = originScrollContainer.scrollTop;

  // You can also set the `overflow` and `height` properties of the printed container to show all content.
  // printedScrollContainer.style.overflow = "visible";
  // printedScrollContainer.style.height = "fit-content";

  printWindow.contentWindow.print();
}

const handlePrint = useReactToPrint({
  // ...
  print: customToPrint,
});

In addition to the methods in the above example, you can also simply add a CSS class name to the scrolling container when printing to show all content.

Set the container to overflow: visible; height: fit-content when printing, cancel the scrolling behavior when the content overflows, and make the height adapt to the content.

@media print {
  .scroll-container {
    overflow: visible;
    height: fit-content;
  }
}

Note:

• If the styles do not take effect, you can try using the !important modifier.
• The styles provided in the above instructions are for reference only. Complex situations may require more styles to achieve the desired result.

NOTE: The library is built and tested locally using Node ^20.

• Clone the repo
• npm ci
• npm start

• vue-to-print: vue3 version of react-to-print