# Elementname: `NewPage`

## Description

Finishes the current page and creates a new one (only if new material for the page is available).

Allowed attributes: openon, pagetype, skippagetype

Child elements: (none)

Parent elements: AtPageCreation, AtPageShipout, Case, Contents, ForAll, Loop, Otherwise, Record, SavePages, Until, While

### Attributes

openon (optional)

  The next current page will be a left or a right page. E.g. when on page 1 and openon="right" then page 2 is empty and the next current page is 3.

  left: | The next objects will be placed on a left page.
  right: | The next objects will be placed on a right page.

pagetype (text, optional)

  The name of the next page type that should be used.

skippagetype (text, optional)

  The pagetype of the blank page if inserted (see the attribute openon).

## Example

    <Record element="data">
      <PlaceObject>
        <Textblock>
          <Paragraph><Value>This is page 1</Value></Paragraph>
        </Textblock>
      </PlaceObject>
      <NewPage openon="right"/>
      <PlaceObject>
        <Textblock>
          <Paragraph><Value>And this is page 3</Value></Paragraph>
        </Textblock>
      </PlaceObject>
    </Record>

## See also

Pagetype

# Commands

- A
- Action
- AddSearchpath
- AtPageCreation
- AtPageShipout
- AttachFile
- Attribute
- B
- Barcode
- Bold
- BoldItalic
- Bookmark
- Box
- Br
- Case
- Circle
- Color
- Column
- Columns
- Compatibility
- Contents
- Copy-of
- DefineColor
- DefineFontalias
- DefineFontfamily
- DefineTextformat
- Element
- Fontface
- ForAll
- Frame
- Grid
- Group
- Groupcontents
- HSpace
- Hyphenation
- I
- Image
- Include
- Initial
- InsertPages
- Italic
- Layout
- Li
- LoadDataset
- LoadFontfile
- Loop
- Makeindex
- Margin
- Mark
- Message
- NewPage
- NextFrame
- NextRow
- NoBreak
- Ol
- Options
- Otherwise
- Output
- Overlay
- PDFOptions
- Pageformat
- Pagetype
- Paragraph
- PlaceObject
- Position
- PositioningArea
- PositioningFrame
- ProcessNode
- Record
- Regular
- Rule
- SaveDataset
- SavePages
- SetGrid
- SetVariable
- SortSequence
- Span
- Stylesheet
- Sub
- Sup
- Switch
- Table
- Tablefoot
- Tablehead
- Tablerule
- Td
- Text
- Textblock
- Tr
- Trace
- Transformation
- U
- URL
- Ul
- Until
- VSpace
- Value
- While

Version: 3.2.0 | Start page | Command reference | Other language: German