Page title

--- title: "PAGE object type in TypoScript" manual: "TypoScript Explained" version: "main" permalink: "https://docs.typo3.org/permalink/t3tsref:object-type-page@main" source: "TopLevelObjects/Page/Index.rst" modified: "2026-09-15T19:22:01+00:00" --- # `PAGE` object type in TypoScript This defines what is rendered in the frontend. PAGE is an object type. A good habit is to use `page` as the top-level object name for the main `PAGE` object of a website. TYPO3 does not initialize `page` by default. You must initialize this explicitly, for example: **EXT:site_package/Configuration/Sets/Main/setup.typoscript** ```typoscript page = PAGE ``` Pages are referenced by two main values. The "id" and "type". **The "id"** points to the uid of the page (or the alias). Thus the page is found. Most of this code is executed in the PHP script `\TYPO3\CMS\Frontend\Http\RequestHandler`. **Table of contents** - [Getting started with the PAGE object](https://docs.typo3.org/permalink/t3tsref:getting-started-with-the-page-object@main) - [Output of the PAGE object](https://docs.typo3.org/permalink/t3tsref:output-of-the-page-object@main) - [Multiple pages](https://docs.typo3.org/permalink/t3tsref:multiple-pages@main) - [Properties](https://docs.typo3.org/permalink/t3tsref:properties@main) - [Page property examples](https://docs.typo3.org/permalink/t3tsref:page-property-examples@main) ## Getting started with the PAGE object See [PAGE in TypoScript (Getting started),](https://docs.typo3.org/permalink/t3tsref:guide-page@main) for an introduction into this object. If no `PAGE` object is found, the error "No page configured for type=0." is displayed. See chapter [Troubleshooting](https://docs.typo3.org/permalink/t3tsref:guide-troubleshooting@main). ## Output of the PAGE object An empty `PAGE` object without further configuration renders a HTML page like the following: **Example output** ```html Page title ``` This default behaviour can be changed by setting the property [Provide JSON and disable HTML headers](https://docs.typo3.org/permalink/t3tsref:setup-config-disableallheadercode@main): **EXT:site_package/Configuration/Sets/Main/setup.typoscript** ```typoscript page.config.disableAllHeaderCode = 1 ``` If the output represents another format different from HTML the HTTP header should also be set, for example: **EXT:site_package/Configuration/Sets/Main/setup.typoscript** ```typoscript page.config.additionalHeaders.10.header = Content-type:application/json ``` ## Multiple pages When rendering pages in the frontend, TYPO3 uses the GET parameter **"type"** to define how the page should be rendered. This is primarily used with different representations of the same content. Your default page will most likely have type 0 (which is the default) while a JSON stream with the same content could go with type 1. The property [typeNum](https://docs.typo3.org/permalink/t3tsref:setup-page-typenum@main) defines for which type, the page will be used. Example: **EXT:site_package/Configuration/Sets/Main/setup.typoscript** ```typoscript page = PAGE page.typeNum = 0 page { # set properties ... } json = PAGE json.typeNum = 1 # ... ``` See [An example page type used for JSON data](https://docs.typo3.org/permalink/t3tsref:page-examples-json@main) about an example for the latter page. In the frontend, the original URLs that are generated will include the type and an id parameter (for the page id), example (for json and page id 22): `/index.php?id=22&type=1` ### Guidelines Good, general PAGE object names to use are: - **page** for the main page with content - **json** for a json stream with content - **xml** for a XML stream with content These are just recommendations. However, especially the name page for the content bearing page is very common and most documentation will imply that your main page object is called page. ## Properties **Properties of the PAGE object** **1,2,3,4...** - **1,2,3,4...** - *Type:* [cObject](https://docs.typo3.org/permalink/t3tsref:data-type-cobject@main) - *Examples:* - [Render "Hello World"](https://docs.typo3.org/permalink/t3tsref:setup-page-array-example@main) - [A simple "Hello World" Example](https://docs.typo3.org/permalink/t3tsref:page-examples-hello-world@main) - [A page using a Fluid template](https://docs.typo3.org/permalink/t3tsref:page-examples-fluid@main) These properties can be used to define any number of objects, just like you can do with a [COA content object](https://docs.typo3.org/permalink/t3tsref:cobj-coa@main). The content of these objects will be rendered on the page in the order of the numbers, not in the order they get defined in the TypoScript definition. It is considered best practice to leave space between the numbers such that it will be possible to place objects before and after other objects in the future. Therefore you will often see that people use the number 10 and no number 1 is found. **bodyTag** - **bodyTag** - *Type:* string - *Default:* `` - *Example:* [Set a class on the body tag](https://docs.typo3.org/permalink/t3tsref:setup-page-bodytag-example@main) Body tag on the page **bodyTagAdd** - **bodyTagAdd** - *Type:* [string](https://docs.typo3.org/permalink/t3tsref:data-type-string@main) - *Example:* [Add a parameter to the body tag](https://docs.typo3.org/permalink/t3tsref:setup-page-bodytagadd-example@main) This content is added inside of the opening `` tag right before the `>` character. This is mostly useful for adding attributes to the `` tag. **bodyTagCObject** - **bodyTagCObject** - *Type:* cObject This is the default body tag. It is overridden by [bodyTag](https://docs.typo3.org/permalink/t3tsref:confval-page-bodytag@main), if that is set. > [!NOTE] > Additionally to the body tag properties noted here, > there also is the property [config.disableBodyTag](https://docs.typo3.org/permalink/t3tsref:confval-config-disablebodytag@main), > which, if set, disables body tag generation independently > from what might be set here. **config** - **config** - *Type:* [->CONFIG](https://docs.typo3.org/permalink/t3tsref:config@main) - *Examples:* - [A page type used for ajax requests](https://docs.typo3.org/permalink/t3tsref:page-examples-ajax@main) - [A page type used for JSON data](https://docs.typo3.org/permalink/t3tsref:page-examples-json@main) - **Configuration for the page. Any entries made here override the same** entries in the top-level object [config: TypoScript configuration](https://docs.typo3.org/permalink/t3tsref:config@main). **cssInline.\[array\]** - **cssInline.\[array\]** - *Type:* [cObject](https://docs.typo3.org/permalink/t3tsref:data-type-cobject@main) - *Example:* [Add inline styles for the h1 tag](https://docs.typo3.org/permalink/t3tsref:setup-page-cssinline-example@main) Allows to add inline CSS to the page `` section. The `cssInline` property contains any number of numeric keys, each representing one cObject. Internally handled as PHP integer, maximum number is therefore restricted to `PHP_INT_MAX`. **footerData.\[array\]** - **footerData.\[array\]** - *Type:* [cObject](https://docs.typo3.org/permalink/t3tsref:data-type-cobject@main) - *Example:* [Add a script and a comment to the page footer](https://docs.typo3.org/permalink/t3tsref:setup-page-footerdata-example@main) Same as [Properties](https://docs.typo3.org/permalink/t3tsref:setup-page-headerdata@main), except that this block gets included at the bottom of the page (just before the closing `` tag). The `footerData` property contains any number of numeric keys, each representing one cObject. Internally handled as PHP integer, maximum number is therefore restricted to `PHP_INT_MAX`. **headerData.\[array\]** - **headerData.\[array\]** - *Type:* [cObject](https://docs.typo3.org/permalink/t3tsref:data-type-cobject@main) Inserts custom content in the head section of the website. While you can also use this to include stylesheet references or JavaScript, you should better use [page.includeCSS](https://docs.typo3.org/permalink/t3tsref:confval-page-includecss@main) and [page.includeJS](https://docs.typo3.org/permalink/t3tsref:confval-page-includejs@main) for such files. Features like file concatenation and file compression will not work on files, which are included using `headerData`. For meta tags, use the dedicated configuration [page.meta](https://docs.typo3.org/permalink/t3tsref:confval-page-meta@main). By default, gets inserted after all the style definitions. The `headerData` property contains any number of numeric keys, each representing one cObject. Internally handled as PHP integer, maximum number is therefore restricted to `PHP_INT_MAX`. **headTag** - **headTag** - *Type:* string / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main) - *Default:* `` Head-tag if alternatives are wanted **includeCSS.\[array\]** - **includeCSS.\[array\]** - *Type:* [resource](https://docs.typo3.org/permalink/t3tsref:data-type-resource@main) - *Example:* [Include additional css files](https://docs.typo3.org/permalink/t3tsref:setup-page-includecss-example@main) > [!NOTE] > **Changed in version 14.0** > > TYPO3 no longer supports frontend asset concatenation or pre-compression > in the core. The file properties `external`, > `disableCompression` and > `excludeFromConcatenation` are therefore not available in > TYPO3 v14 and above. See > [Frontend asset concatenation and compression not supported](https://docs.typo3.org/permalink/t3tsref:frontend-asset-concat-compress-not-supported@main). Inserts a stylesheet (just like the `stylesheet` property), but allows setting up more than a single stylesheet, because you can enter files in an array. The file definition must be a valid [resource](https://docs.typo3.org/permalink/t3tsref:data-type-resource@main) data type, otherwise nothing is inserted. Each file has *optional properties*: - **`allWrap`** Wraps the complete tag, useful for conditional comments. - **`allWrap.splitChar`** Defines an alternative splitting character (default is "|" - the vertical line). - **`alternate`** If set (boolean) then the rel-attribute will be "alternate stylesheet". - **`forceOnTop`** Boolean flag. If set, this file will be added on top of all other files. - **`if`** Allows to define conditions, which must evaluate to `true` for the file to be included. If they do not evaluate to `true`, the file will not be included. Extensive usage might cause huge numbers of temporary files to be created. See [function if](https://docs.typo3.org/permalink/t3tsref:if@main) for details. - **`inline`** If set, the content of the CSS file is inlined using `