--- 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: auth-node-ref version: 8 page_id: auth-node-ref::page canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/page.html llms_txt: https://docs.pingidentity.com/auth-node-ref/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"] superseded_by: https://docs.pingidentity.com/auth-node-ref/latest/page.html section_ids: example: Example availability: Availability inputs: Inputs dependencies: Dependencies configuration: Configuration outputs: Outputs callbacks: Callbacks outcomes: Outcomes errors: Errors --- # 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. ## 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) ## 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 This node has no dependencies. ## 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 | Optional. A stage name to pass to the client to aid in rendering. NOTE: You can't configure a Stage for this node if you configure a Page Footer, Theme or Submit Button Text. These properties overwrite the value of the Stage property. | | Submit Button Text | Optional. Use the Key and Value fields to set the text of the Submit button. This property isn't visible in the AM admin UI. It requires a Ping Identity Platform deployment. | | 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.Ping Identity Platform deployments only: You can use HTML code to format the description. This property isn't visible in the AM admin UI. It requires a Ping Identity Platform deployment. | | Theme | Optional. If using hosted pages, specify a theme to override this journey's UI theme. This property isn't visible in the AM admin UI. It requires a Ping Identity Platform deployment. | | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | 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. ## Callbacks This node doesn't send any callbacks. ## 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 The node can log the following errors: * `Failed to collect inputs of contained node: node name` The *node name* couldn't retrieve required properties from the shared node state. * `Failed to collect outputs of contained node: node name` The *node name* couldn't 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. The node can throw exceptions with the following messages during operation: * `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. The node can throw exceptions with the following messages when saving the journey: * `Illegal child node type: node type` A Page node can't contain a *node type*. * `Node does not have any outcomes: node type` 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: node id` Use the journey editor to fix the problem. * `Could not load child node: node` Use the journey editor to fix the problem. * `Could not obtain outcomes for node: node` Use the journey editor to fix the problem.