Add or edit an architectural decision record \(ADR\)

---
title: Add or edit an architectural decision record \(ADR\)
description: Create or update an artifact of the type architectural decision record \(ADR\) to align it with your business requirements.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/application-portfolio-management/eaw-create-edit-adr.html
release: brazil
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Manage architectural decision records \(ADR\), Working with information portfolio, Working with Portfolio list view, Managing Enterprise Architecture Workspace, Enterprise Architecture Workspace, Enterprise Architecture]
---

# Add or edit an architectural decision record \(ADR\)

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 **Workspaces** > **Enterprise Architecture Workspace**.

2.  Open the Portfolio List view by selecting the Portfolio icon \[Omitted image "portfolio-icon.png"\] Alt text: Portfolio icon.

3.  Select the expand row icon \(\[Omitted image "ExpandIcon.png"\] Alt text: 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.
6.  In the **New architectural artifact** pop-up window, fill in the form fields.

    For field information, see [Architectural artifact form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-new-arct-artfct-form.md).

7.  Select **Create**.


## 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.

**Parent Topic:**[Manage architectural decision records \(ADR\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-manage-adr.md)

**Related topics**  


[eaw-add-an-architectural-artifact-version]

[Request approval for an architectural artifact](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-req-approval-artifact-version.md)

[Add a related entity to an architectural artifact](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-add-a-related-entity-to-an-architectural-artifact.md)

[Create and manage pages and subpages for ADRs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-create-and-mng-page-subpage-for-adr.md)

[Tag users or records in Architectural Decision Records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-tag-users-or-records-in-adr.md)

[Reference additional records in decision records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-update-system-property-to-allow-tagging-of-additional-records-in-adr-doc.md)

[Add an architectural decision record version](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-add-an-adr-version.md)

[Request approval for an ADR version](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-portfolio-management/eaw-request-approval-adr.md)