--- title: Page node description: Configure the Page node to combine multiple input-collecting nodes onto a single page displayed to users during an authentication journey. component: platform version: 7.5 page_id: platform:auth-node-ref:page canonical_url: https://docs.pingidentity.com/platform/7.5/auth-node-ref/page.html llms_txt: https://docs.pingidentity.com/platform/llms.txt docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md keywords: ["Nodes & Trees", "Journeys", "Authentication"] page_aliases: ["auth-node-page.adoc"] section_ids: availability: Availability inputs: Inputs dependencies: Dependencies configuration: Configuration outputs: Outputs outcomes: Outcomes errors: Errors example: Example --- # Page node The Page node lets you combine multiple nodes that request input onto a single page for display to the user. For example, you can use it to create a single login page that requests a username and password. | | | | - | ------------------------------------------------------------------------- | | | The Page node can only include nodes that use callbacks to request input. | To use it, drag and drop compatible nodes onto the Page node in the journey editor. When designing a journey that includes a Page node, consider the following points: * A Page node must contain at least one node. * Page nodes can't be nested inside each other. Similarly, you can't include an [Inner Tree Evaluator node](inner-tree-evaluator.html) in a Page node. * Page nodes are designed to group nodes together that require user input. Non-interactive nodes, such as the [Data Store Decision node](data-store-decision.html) or [Push Sender node](push-sender.html), should be placed outside of Page nodes. * Scripted Decision nodes can be included in Page nodes but only if they handle callbacks. Scripts that use the `Action` class to set messages (using fields such as `lockoutMessage` or `errorMessage`) aren't supported within a Page node. * Only the final node can have multiple outcomes. All preceding nodes must have a single outcome path. ## Availability | Product | Available? | | ------------------------------------- | ---------- | | PingOne Advanced Identity Cloud | Yes | | PingAM (self-managed) | Yes | | Ping Identity Platform (self-managed) | Yes | ## Inputs The inputs are determined by the collective inputs of the contained nodes. ## Dependencies None. ## Configuration | Property | Usage | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Page Header | Optional. A localized title for the Page node and the nodes contained within it. Use this when components of an authentication journey need a title; for example, dividing a registration flow into labeled sections. | | Page Description | Optional. A localized description for the Page node and the nodes contained within it. Use this when you need additional descriptive text in an authentication journey. In a Ping Identity Platform deployment, you can use HTML code to format the description. | | Stage | An optional stage name to pass to the client to aid in rendering. | | Submit Button Text | Optional. Use the Key and Value fields to set the text of the Submit button.This property is available only in the Ping Identity Platform admin UI. | | Page Footer | Optional. A localized footer for the page node and the nodes contained within it. Use this when you need additional descriptive text in an authentication journey. In a Ping Identity Platform deployment, you can use HTML code to format the footer.This property is available only in the Ping Identity Platform admin UI. | | Theme | Optional. If using hosted pages, specify a theme to override this journey's UI theme.This property is available only in the Ping Identity Platform admin UI. | | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | This node's optional properties are passed in the response, but a self-hosted or custom UI must support these properties to make them visible to the end user. | ## Outputs The outputs are determined by the collective outputs of the contained nodes. ## Outcomes The outcomes are determined by the last node in the Page node. Only the last node in the page can have more than one outcome path. ## Errors This node can log the following error messages: | Message | Notes | | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `Failed to collect inputs of contained node: ` | The \ could not retrieve required properties from the shared node state | | `Failed to collect outputs of contained node: ` | The \ could not retrieve required properties to include in the shared node state | | `Could not find the identity based on the information available on context` | Failed to find the account profile with this `username` in this `realm` | | `An error occurred when trying to lock out the user account` | Failed to update the account status; applies when locking and unlocking the account | This node can throw exceptions with the following messages during operation: | Message | Notes | | ------------------------------------------------- | ---------------------------------------------------------------- | | `This page has no nodes in it, so cannot proceed` | A Page node must contain at least one other node | | `No outcome and only metadata callbacks found` | Failed to get to an outcome while processing the contained nodes | | `Node properties cannot be fetched` | Failed to access the properties of a contained node | This node can throw exceptions with the following messages when saving the journey: | Message | Notes | | ------------------------------------------------------------- | ------------------------------------------------------------ | | `Illegal child node type: ` | A Page node can't contain a \ | | `Node does not have any outcomes: ` | The contained nodes must have at least a single outcome path | | `Only the last node in a page can have more than one outcome` | Consider rearranging the contained nodes | | `Node does not exist: ` | Use the journey editor to fix the problem | | `Could not load child node: ` | Use the journey editor to fix the problem | | `Could not obtain outcomes for node: ` | Use the journey editor to fix the problem | ## Example The following example uses a Page node containing a [Platform Username node](platform-username.html), [Platform Password node](platform-password.html), and [Choice Collector node](choice-collector.html): ![Example journey showing Page node use](_images/trees-node-page-example-platform.png) The flow prompts the user for all input on a single page: ![User's view of an example journey containing a Page node](_images/trees-node-page-example-output-platform.png)