Skip to content

CSS module: paged media #40970

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Sep 3, 2025
+19 −11
Merged

CSS module: paged media #40970

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
153fba3
CSS module: paged media
estelle Sep 1, 2025
b19d432
Apply suggestions from code review
estelle Sep 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 19 additions & 11 deletions files/en-us/web/css/css_paged_media/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,30 +6,39 @@ spec-urls: https://drafts.csswg.org/css-page/
sidebar: cssref
---

The **CSS paged media** module defines the properties that control the presentation of content for print or any other media that splits content into discrete pages. It allows you to set page breaks, control printable areas, style left and right pages differently, and control breaks inside elements.
The **CSS paged media** module defines the properties that control the presentation of content for print or any other media that splits content into discrete pages. It allows you to set page breaks, control printable areas, and style left and right pages differently.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there any other media type that splits content into discrete pages? Browser reader modes might use it, perhaps, but that's not really a separate media type. I'm not 100% sure if anything needs to be done here, but this is a question other readers might ask.


The CSS paged media module specifies how pages are generated and laid out to hold fragmented content in a paged presentation, including content that is printed or represented as a print preview. The module defines functionality for controlling page margins, size, orientation, and headers and footers. It extends [generated content](/en-US/docs/Web/CSS/CSS_generated_content) to provide functionality for generating page numbers and running headers and footers.

The process of paginating content into generated pages and controlling breaks inside elements is covered in the [CSS fragmentation module](/en-US/docs/Web/CSS/CSS_fragmentation).

## Reference

### Properties

- {{cssxref('page')}}
- {{cssxref("page")}}

### At-rules

- {{cssxref('@page')}}
- {{cssxref('@page/page-orientation', 'page-orientation')}} descriptor
- {{cssxref('@page/size', 'size')}} descriptor
- {{cssxref("@page")}}
- {{cssxref("@page/page-orientation", "page-orientation")}} descriptor
- {{cssxref("@page/size", "size")}} descriptor
- [Margin descriptors](/en-US/docs/Web/CSS/margin)
- [Margin at-rules](/en-US/docs/Web/CSS/@page#margin_at-rules)

The CSS paged media module also introduces the `bleeds` and `marks` `@page` descriptors. Currently, no browsers support these features.
The CSS paged media module also introduces the `bleeds` and `marks` descriptors of the `@page` at-rule. Currently, no browsers support these features.

### Pseudo-classes

- {{cssxref(':blank')}}
- {{cssxref(':first')}}
- {{cssxref(':left')}}
- {{cssxref(':right')}}
- {{cssxref(":blank")}}
- {{cssxref(":first")}}
- {{cssxref(":left")}}
- {{cssxref(":right")}}

## Guides

- [Printing](/en-US/docs/Web/CSS/CSS_media_queries/Printing)
- : Tips and techniques for helping improve web content printer output.

## Related concepts

Expand All @@ -46,6 +55,5 @@ The CSS paged media module also introduces the `bleeds` and `marks` `@page` desc

## See also

- [Printing](/en-US/docs/Web/CSS/CSS_media_queries/Printing) guide
- [CSS fragmentation](/en-US/docs/Web/CSS/CSS_fragmentation) module
- [CSS media queries](/en-US/docs/Web/CSS/CSS_media_queries) module