Add or edit an architectural decision record (ADR)

  • Release version: Zurich
  • Updated July 31, 2025
  • 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.

    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 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.
    6. In the New architectural artifact pop-up window, fill in the form fields.
      For field information, see Architectural artifact form.
    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.