---
sourceDocument: Zurich Enterprise Architecture (formerly Application Portfolio Management)
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/application-portfolio-management

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Enterprise Architecture (formerly Application Portfolio Management)

ft:clusterId :

    - appportman

bundleId :

    - appportman

workflow :

    - Technology


---

# Add or edit an architectural decision record (ADR)

# Add or edit an architectural decision record (ADR) {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Create or update an artifact of the type architectural decision record (ADR) to align it with your business requirements.

## Before you begin

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](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB2017926).

The permission set at the artifact level determines if you can edit the artifact.

Role required: sn_apm.apm_user to add an architectural decision record (ADR).

## Procedure

1. Navigate to WorkspacesEnterprise Architecture Workspace.
2. Open the Portfolio List view by selecting the Portfolio icon ![Portfolio icon]().
3. Select the expand row icon (![Expand Row icon]()) next to Information Portfolio.
4. Select Architectural Decision Records (ADR).
5. Add or edit an architectural decision record.  
   * To add an architectural decision record, select New.
   * To update details of an existing architectural decision record, select the architectural decision record.
   {#eaw-create-edit-adr__ul_dqn_b4q_ybc}
6. In the New architectural artifact pop-up window, fill in the form fields.  
   For field information, see [Architectural artifact form](https://www.servicenow.com/docs/KPJuUMAgPdu0z71rEUZouA "Architectural artifacts describe a system, solution, or state of an enterprise. The architectural artifacts in Enterprise Architecture enable enterprise architects to create and manage the artifacts used in their organization.").
7. Select Create.
{#eaw-create-edit-adr__steps_iqc_lyh_rcc}

## Result

The architectural decision record is created and added to the artifacts list. You're also redirected to the newly created architectural decision record page.
**Related tasks**   

* [Request approval for an architectural artifact](https://www.servicenow.com/docs/OQLBKpz3tMQF4BuRgJ66aQ "You can request approval for architectural artifacts of the type URL or Attachment from users who are part of the Enterprise Architect user group. The user reviews and approves the request.")
* [Add a related entity to an architectural artifact](https://www.servicenow.com/docs/F5P8KR0f6RDe7CfiuuMCdQ "Associate an architectural artifact to existing entities such as business capabilities, business applications, digital integrations, and digital interfaces. The association creates a relationship between the artifact and related entities.")
* [Create and manage pages and subpages for ADRs](https://www.servicenow.com/docs/~YiekIKqdmFSb2v014HR3g "Flexibly organize information for your architectural decision records (ADR) by creating, duplicating, and deleting pages and subpages in the Enterprise Architecture Workspace.")
* [Tag users or records in Architectural Decision Records](https://www.servicenow.com/docs/Pupsejm~5v4TjcvLJTjgzg "You can tag users or records in architectural decision records (ADR) in the Enterprise Architecture Workspace.")
* [Reference additional records in decision records](https://www.servicenow.com/docs/kOGnxgWJZwODsub2FuGnbw "You can customize the default values of the sn_apm_ws.record_mention_config system property to enable the tagging of additional record tables in an architectural decision record (ADR).")
* [Add an architectural decision record version](https://www.servicenow.com/docs/KyGwBzOXy0nDMVGdfA7Kxg "Create multiple versions of architectural decision records (ADR) in the Enterprise Architecture Workspace. Creating multiple ADR versions enable you to capture the evolution of architectural decisions over time or capture details of alternatives to existing architectural decisions.")
* [Request approval for an ADR version](https://www.servicenow.com/docs/F8zExiS~dwGFQcwq6gNBcw "Send a version of architectural artifacts of the type Architectural Decision Record (ADR) for approval to an Enterprise Architect user. The user reviews and approves the request.")  
**Related topics**   

* 

*[\>]: and then