---
sourceDocument: Brazil Enterprise Architecture
sourceDocumentLink: https://www.servicenow.com/docs/r/application-portfolio-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Enterprise Architecture

ft:clusterId :

    - appportman

bundleId :

    - appportman

workflow :

    - Technology


---

# Replace a shape in a diagram

# Replace a shape in a diagram {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Replace any shape on the diagram canvas with a different shape type. When you replace a shape, relationship lines update automatically to reflect the new shape type.

## Before you begin

You must have the Owner or Editor access to the artifact or diagram.

Role required: sn_apm.apm_user

## About this task

You can replace any shape on the canvas with a different shape type, including CI shapes, ArchiMate shapes, and general shapes. When you replace a shape:

* CI or reference relationship lines update to reflect the relationship between the new shape types.
* ArchiMate relationship lines update based on the new shape type.
* If both the original and replacement shapes are general shapes, relationship lines remain unchanged.
* Labels on relationship lines are preserved after the replacement.

You can also update the entity associated with a shape without changing the shape type.

## Procedure

1. Navigate to WorkspacesEnterprise Architecture Workspace.
2. Open the Modeling page by selecting the Enterprise Modeling and Visualization icon (![Enterprise Modeling and Visualization]()).
3. Select an existing diagram from the Diagrams page.
4. Select the shape you want to replace.
5. Open the side panel for the selected shape by selecting the Open side panel icon (![Open side panel]()).
6. In the Shape Type field, search for and select the shape type you want to use as the replacement.  
   You can type in the field to filter the list of available shape types.
7. Select and map an existing entity or create an entity for the replacement shape.
   * To associate an existing entity, select Choose Existing and select an entity from the list.
   * To create an entity, select Create New and enter the required details.
8. Select Update.

## Result

The shape is replaced on the canvas. Relationship lines between the replaced shape and connected shapes update based on the new shape type, and labels on relationship lines are preserved. If the shape was part of a group, it
remains in the group after the replacement.
**Related concepts**   

* [ArchiMate shapes support in the Enterprise Modeling and Visualization](https://www.servicenow.com/docs/7cGQLcboln1kw4FgjS9zlA "ArchiMate shapes are industry-standard elements used by enterprise architects to create diagrams that represent relationships across different domains of an enterprise. ArchiMate is a registered trademark of The Open Group. Enterprise Modeling and Visualization supports ArchiMate shapes along with General and Enterprise Architecture shapes.")  
**Related tasks**   

* [Synchronize a shape to the database](https://www.servicenow.com/docs/j~TniwpDt8P4zOcW2YR62Q "Add a shape to a diagram. Synchronize the shape to the database by mapping the shape to an existing CI or adding a CI.")
* [Delete a shape](https://www.servicenow.com/docs/2oKFj2QpuQ4~QzBOfwbkXg "Delete a shape and all of its relationships from a diagram.")
* [Add related records in the modeling diagram](https://www.servicenow.com/docs/sNA5aOR1k5WqD6KmPfb0oA "Fetch and add specific related records to the selected shape in a diagram.")  
**Related reference**   

* [Shapes to create a modeling diagram](https://www.servicenow.com/docs/XD2G9NSsAC9ta56HwcORgg "The shapes available in Enterprise Modeling and Visualization help you create diagrams. You can add a shape to the canvas by either selecting the shape or by dragging the shape from the Shapes palette to the canvas.")

*[\>]: and then