Participants and groups

Name the objects in your flow and organize them with styled groups and icons.

Acefy Architecture Language (AAL) · AAL Sequence 0.1 · Dictionary 0.1.0

On this page

Participants and icons

Participants are shared definitions. Name, type, description, technology, and explicit icon changes appear everywhere that participant is used. Each sequence has its own participant membership, column order, widths, colors, and lifelines.

TypeTypical use
actor / personA person or initiating role
system / externalAn application or external system
service / api / componentA service, endpoint, or implementation component
databaseA data store
queue / event-brokerAsynchronous delivery or an event broker

Every type has a generic icon, even when pasted AAL omits an icon. Select a participant → Icon in the floating toolbar to search the shared catalog. The inspector also offers Change icon. Reset to Automatic removes the explicit choice. A missing image falls back visually without modifying its saved icon path.

Optional participant icon
participant Auth "Authentication API" {
    type api
    technology "HTTPS"
    icon "/deployment-icons/generic/integration.svg"
}

Checkerboard previews show the artwork itself. Filter All backgrounds, Transparent, Built-in background, or Unreviewed. A built-in background stays with the artwork; a light backdrop for readability is identified separately. Unreviewed icons keep their existing backdrop automatically. Icon plate in the toolbar and inspector offers Automatic, Show, or Hide for participant and group headers. Hide removes Acefy’s white plate while preserving any background built into the artwork.

Drag a header horizontally to change its local column order. Select it to expose left/right resize handles; focus a handle and use the arrow keys for precise width changes. Icons stay on the left and names wrap on the right.

Participant groups

Use Add group to place related participants inside a named band, like an application or external platform. Select the band heading to rename it, set a custom type, choose an icon, edit membership, style its background, border and text, or ungroup. Participants and messages survive ungrouping.

Shared participant group
group Platform "Digital Application" {
    participants [Portal, Auth]
    type "Application"
    icon "/deployment-icons/generic/application.svg"
}

Each participant belongs to at most one group; groups cannot nest and must contain a participant. Membership is shared across all sequences. Groups show their visible members in contiguous columns and extend behind their lifelines. Colors stay in diagram appearance settings; groups do not replace fragments or sequence membership. The icon, name, and type align at the top left. Omitted types display as Group and omitted icons use a generic component icon. The box and header space adjust to fit the visible participants and wrapped text.