---
sourceDocument: Australia Enterprise Architecture (formerly Application Portfolio Management)
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/application-portfolio-management

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia 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}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

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

## Antes de Iniciar

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

## Procedimento

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 [New architectural artifact form](https://servicenow-prod.fluidtopics.net/TymTJh3C1Lj7RkBRitDxLQ "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}

## Resultado

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

* [Add an architectural artifact version](https://servicenow-prod.fluidtopics.net/xtx5Cj4OHdkThNgig_H2AQ "Create multiple versions of architectural artifacts in the Enterprise Architecture Workspace.")
* [Request approval for an architectural artifact of type URL or Attachment](https://servicenow-prod.fluidtopics.net/HCGGuEUUK7oWYxkyrK1AZQ "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://servicenow-prod.fluidtopics.net/B90JeSpypRFwbXBbVnEveg "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 architectural decision records](https://servicenow-prod.fluidtopics.net/2JuZjNjg7HSmKxV7zYR7Mw "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://servicenow-prod.fluidtopics.net/OYJFTiu8ta3OjjuQP2WyPQ "You can tag users or records in architectural decision records (ADR) in the Enterprise Architecture Workspace.")
* [Enable referencing additional records in architectural decision records](https://servicenow-prod.fluidtopics.net/WOIN3ECh5kTachkAzSz0kg "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://servicenow-prod.fluidtopics.net/QzsnZDsc3pz~l4r3dX2CAQ "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 architectural artifact version of type Architectural Decision Record](https://servicenow-prod.fluidtopics.net/iQyPwlveCeErPDs3yr3AkQ "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.")