Manage architectural decision records \(ADR\)

concept australia Updated Sep 10, 2026 1 min read eaw-manage-adr.md

The Architectural Decision Records (ADR) help you to explain your infrastructure. ADR is a type of artifact that helps in understanding the background of a specific architectural decision.

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.
Generate a summary for Architectural Decision Records (ADRs)
Quickly learn the details of the Architectural Decision Records (ADR) from the summary that is generated by ServiceNow Otto® in the Enterprise Architecture Workspace. Use ServiceNow Otto® to generate summaries of large ADR artifacts and understand architectural decisions faster.
Elaborate or shorten content in ADRs
Elaborate or shorten the Architectural Decision Records (ADR) content using ServiceNow Otto® in the Enterprise Architecture Workspace.
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.
Tag users or records in Architectural Decision Records
You can tag users or records in architectural decision records (ADR) in the Enterprise Architecture Workspace.
Reference additional records in decision records
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
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
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.

Parent Topic:Working with information portfolio

36 lines · 4.3 KB Wrap lines

---
title: Manage architectural decision records \(ADR\)
description: The Architectural Decision Records \(ADR\) help you to explain your infrastructure. ADR is a type of artifact that helps in understanding the background of a specific architectural decision.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/application-portfolio-management/eaw-manage-adr.html
release: australia
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Working with information portfolio, Working with Portfolio list view, Managing Enterprise Architecture Workspace, Enterprise Architecture Workspace, Enterprise Architecture]
---

# Manage architectural decision records \(ADR\)

The Architectural Decision Records \(ADR\) help you to explain your infrastructure. ADR is a type of artifact that helps in understanding the background of a specific architectural decision.

-   **[Add or edit an architectural decision record \(ADR\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-create-edit-adr.md)**  
Create or update an artifact of the type architectural decision record \(ADR\) to align it with your business requirements.
-   **[Generate a summary for Architectural Decision Records \(ADRs\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/summarize-docs-genai-skill-ea.md)**  
Quickly learn the details of the Architectural Decision Records \(ADR\) from the summary that is generated by ServiceNow Otto® in the Enterprise Architecture Workspace. Use ServiceNow Otto® to generate summaries of large ADR artifacts and understand architectural decisions faster.
-   **[Elaborate or shorten content in ADRs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/elaborate-shorten-content-ew.md)**  
Elaborate or shorten the Architectural Decision Records \(ADR\) content using ServiceNow Otto® in the Enterprise Architecture Workspace.
-   **[Create and manage pages and subpages for ADRs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-create-and-mng-page-subpage-for-adr.md)**  
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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-tag-users-or-records-in-adr.md)**  
You can tag users or records in architectural decision records \(ADR\) in the Enterprise Architecture Workspace.
-   **[Reference additional records in decision records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-update-system-property-to-allow-tagging-of-additional-records-in-adr-doc.md)**  
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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-add-an-adr-version.md)**  
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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-request-approval-adr.md)**  
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.

**Parent Topic:**[Working with information portfolio](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-portfolio-management/eaw-work-with-info-portfoliodita.md)