Skip to content
Release: Australia · Updated: 2026-05-15 · Official documentation · View source

Replace a shape in a diagram

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

  2. Open the Modeling page by selecting the Enterprise Modeling and Visualization icon (

Image omitted: icon-modeling-logo.png
Enterprise Modeling and Visualization\).
  1. Select an existing diagram from the Diagrams page.

  2. Select the shape you want to replace.

  3. Open the side panel for the selected shape by selecting the Open side panel icon (

Image omitted: icon-open-side-panel.png
Open side panel\).
  1. 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.

  2. 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.
    • 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.

Parent Topic:Working with Enterprise Modeling and Visualization

Related topics

Shapes to create a modeling diagram

Synchronize a shape to the database

Delete a shape

Add related records in the modeling diagram

ArchiMate shapes support in the Enterprise Modeling and Visualization