Swimlane Diagram Config Schema

https://mermaid.js.org/schemas/config.schema.json#/$defs/SwimlaneDiagramConfig

The object containing configurations specific for the swimlanes diagram type.

Swimlanes reuses the flowchart renderer and flowchart config for shared options (curve, htmlLabels, spacing, …); this block holds the knobs that only affect the swimlanes layout pipeline.

Abstract	Extensible	Status	Identifiable	Custom Properties	Additional Properties	Access Restrictions	Defined In
Can be instantiated	No	Unknown status	No	Forbidden	Allowed	none	config.schema.json*

SwimlaneDiagramConfig Type

object (Swimlane Diagram Config)

all of

• Base Diagram Config

SwimlaneDiagramConfig Properties

Property	Type	Required	Nullable	Defined by
lineHops	Merged	Optional	cannot be null	Mermaid Config
ignoreCrossLaneEdges	boolean	Optional	cannot be null	Mermaid Config
optimizeRanksByCrossings	boolean	Optional	cannot be null	Mermaid Config
automaticLaneOrdering	boolean	Optional	cannot be null	Mermaid Config

lineHops

Renders edge crossings as small arcs ("hops") or visible gaps so that overlapping edges are easier to read. Set to false to disable. Edges rendered as curves are skipped to avoid corrupting the geometry.

lineHops

• is optional

• Type: merged type (Details)

• cannot be null

• defined in: Mermaid Config

lineHops Type

merged type (Details)

one (and only one) of

• Untitled boolean in Mermaid Config

• Untitled string in Mermaid Config

lineHops Default Value

The default value is:

"arc"

ignoreCrossLaneEdges

Ignores edges that cross swimlane boundaries during swimlane layer assignment. This can improve rank quality for diagrams with many cross-lane links.

ignoreCrossLaneEdges

• is optional

• Type: boolean

• cannot be null

• defined in: Mermaid Config

ignoreCrossLaneEdges Type

boolean

ignoreCrossLaneEdges Default Value

The default value is:

true

optimizeRanksByCrossings

Enables a crossing-aware rank optimization pass for swimlane layouts.

optimizeRanksByCrossings

• is optional

• Type: boolean

• cannot be null

• defined in: Mermaid Config

optimizeRanksByCrossings Type

boolean

optimizeRanksByCrossings Default Value

The default value is:

true

automaticLaneOrdering

Automatically reorders top-level swimlanes with a deterministic weighted-linear-arrangement heuristic. Disabled by default because source swimlane order can carry semantic meaning.

automaticLaneOrdering

• is optional

• Type: boolean

• cannot be null

• defined in: Mermaid Config

automaticLaneOrdering Type

boolean

automaticLaneOrdering Default Value

The default value is:

false