@page

The @page CSS at-rule is used to modify some CSS properties when printing a document.You can't change all CSS properties with @page. You can only change the margins, orphans, widows, and page breaks of the document. Attempts to change any other CSS properties will be ignored.

@page {
  margin: 1cm;
}

@page :first {
  margin: 2cm;
}

The @page at-rule can be accessed via the CSS object model interface CSSPageRule.

Syntax

Descriptors

size

Specifies the target size and orientation of the page box’s containing block. In the general case, where one page box is rendered onto one page sheet, it also indicates the size of the destination page sheet.

marks

Adds crop and/or registration marks to the document.

bleed

Specifies the extent beyond the page box at which the page rendering is clipped.

Formal syntax

@page <page-selector-list> {
  <page-body>
}
where 
<page-selector-list> = [ <page-selector># ]?
<page-body> = <declaration>? [ ; <page-body> ]? | <page-margin-box> <page-body>
where 
<page-selector> = <pseudo-page>+ | <ident> <pseudo-page>*
<page-margin-box> = <page-margin-box-type> {
  <declaration-list>
}
where 
<pseudo-page> = : [ left | right | first | blank ]
<page-margin-box-type> = @top-left-corner | @top-left | @top-center | @top-right | @top-right-corner | @bottom-left-corner | @bottom-left | @bottom-center | @bottom-right | @bottom-right-corner | @left-top | @left-middle | @left-bottom | @right-top | @right-middle | @right-bottom

Examples

Please refer to the various pseudo-classes of @page for examples.

• :blank
• :first
• :left
• :right
• :recto
• :verso

Specifications

Browser compatibility