Course contentsShow
← React
Lesson 2337 of 2,39651. TypeScript with React BasicsFree lesson

The PropsWithChildren Utility Type

Use React's built-in PropsWithChildren helper to correctly type components that accept children.

The PropsWithChildren Utility Type

What you'll learn: How to use React's built-in PropsWithChildren helper to cleanly type components that accept children.

When building wrapper or layout components, you often need to accept children as a prop. Rather than manually adding children?: ReactNode to every props interface, React provides the PropsWithChildren<T> utility type that does this for you.

What PropsWithChildren Does

PropsWithChildren is a generic type that takes your props interface and automatically adds the optional children property with the correct type (ReactNode). It's essentially a shorthand that saves you from repetitive type definitions.

Think of it like a rubber stamp that marks your props interface as "this component can wrap other elements."

Using PropsWithChildren

Instead of this verbose approach:

interface CardProps {
  title: string;
  children?: React.ReactNode;
}

const Card: React.FC<CardProps> = ({ title, children }) => {
  return <div className="card">
    <h2>{title}</h2>
    {children}
  </div>;
};

You can use PropsWithChildren:

interface CardProps {
  title: string;
}

const Card: React.FC<PropsWithChildren<CardProps>> = ({ title, children }) => {
  return <div className="card">
    <h2>{title}</h2>
    {children}
  </div>;
};

The result is identical—children becomes an optional prop of type ReactNode—but your interface definition stays focused on your component's unique props.

When to Use It

Use PropsWithChildren for wrapper components, layout components, or any component designed to compose other elements. Skip it if your component never uses children.

Key Takeaway: PropsWithChildren<T> is React's built-in helper that adds the optional children prop to your type definition, eliminating boilerplate and making wrapper component types cleaner.