Skip to content
Manage architectural decision records \(ADR\) › Working with information portfolio › Working with Portfolio list view › Managing Enterprise Architecture Workspace › Enterprise Architecture Workspace › Enterprise Architecture
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create and manage pages and subpages for ADRs

Flexibly organize information for your architectural decision records (ADR) by creating, duplicating, and deleting pages and subpages in the Enterprise Architecture Workspace.

Before you begin

An ADR can have multiple doc pages associated with it to help you organize key architectural artifact details. Predefined ServiceNow Docs component (sn_docs) templates are available. You can create ADR pages using one of these templates or start with a blank page.

Note: The ADR feature in Enterprise Architecture Workspace uses the ServiceNow Docs component (sn_docs) to create pages in the Artifacts section. Docs component v6.0.0 is automatically installed with Enterprise Architecture Workspace v3.4.0.

If you’re using an older version of Enterprise Architecture Workspace with Docs component v6.0.0, upgrade the workspace to v3.4.0 to fully use the ADR functionality. For more information, see KB2017926.

Role required: sn_apm.apm_user and you should have Editor access to the ADR.

Procedure

  1. Navigate to Workspaces > Enterprise Architecture Workspace.

  2. Open the Portfolio List view by selecting the Portfolio icon

Image omitted: portfolio-icon.png
Portfolio icon.
  1. Select the expand row icon (
Image omitted: ExpandIcon.png
Expand Row icon\) next to **Information Portfolio**.

  1. Select Architectural Decision Records (ADR).

  2. Select the ADR that you would like to create a doc page for.

  3. To create a page, you can create an empty page or start with a predefined template.

    • For an empty page, select Create page.
    • To create from templates:
      1. Select Create Page from template.
Image omitted: create-adr-page.png
Create page and create page from template buttons.
    2.  Choose a template from the Template Center and select **Use**.
Image omitted: adr-template.png
Page displaying some of the available ADR templates..
        The new page is created and added to your ADR with the name of the selected template, which you can rename.
  1. To create a subpage, select the Page Actions menu icon (
Image omitted: more-actions-menu.png
Page actions menu\) and select **Create subpage**.
Image omitted: create-adr-subpage.png
Page actions menu with the create subpage button highlighted.
  1. To delete a page or a subpage, select the Page Actions menu (
Image omitted: more-actions-menu.png
Page actions menu\) and select **Delete**.

Parent Topic:Manage architectural decision records (ADR)

Related topics

Tag users or records in Architectural Decision Records

Generate a summary for Architectural Decision Records (ADRs)

Elaborate or shorten content in ADRs

Add or edit an architectural decision record (ADR)

Request approval for an ADR version

Add an architectural decision record version

Reference additional records in decision records