PlantUML Q&A - Recent questions and answers in Bug

Answered: Stereotype LifeLine styles are not working with teoz engine

Wed, 22 Jul 2026 10:00:52 +0000

Hello V.,

Thank for the report.

That will now be fixed with new 1.2026.7 (with refactor teoz by default).

Regards,
Th.

Answered: Style lifeline colors fails when teoz is added

Wed, 22 Jul 2026 09:44:03 +0000

Hello R.,

With next plantuml version 1.2026.7, that will be fixed by `teoz` by default:

Regards,
Th.

Answered: Sequence Diagram: Lifeline Vs. Reference or note

Sat, 11 Jul 2026 08:42:38 +0000

Hello D.,

(To fix... an old issue...)

With next plantuml version 1.2026.7, that will be fixed by `teoz` by default:

Regards,
Th.

ports really need a revamp

Wed, 08 Jul 2026 17:44:37 +0000

ports in the component diagram are super useful, but they really need a lot of work. Both the default engine (puma?) and smetana produce incorrect results for the ports.

//www.plantuml.com/plantuml/png/HOrT2W8n48FVSuevobvbN8CkjjEXpJw8U7UBM7m8V87yR4FUTTQ2zFtXDveuP2zawph2xYovk19VRASi2ttmRpkb9x2tcYqOiYE2VUxOh-om5RxW3KnjZEjy_W00

Answered: TEOZ mainframe overlaping box

Wed, 08 Jul 2026 16:30:50 +0000

Hello V.,

That will now be fixed with new 1.2026.7 (with refactor teoz by default).

Regards,
Th.

Unmapped portout causes image to not render

Tue, 07 Jul 2026 17:16:29 +0000

Adding in a 3rd portout to an existing component causes the diagram to not render, removing it does render.

This only happens if I have a link with a label, if the link is unrelated to the component/portout

This happens in the old and new online editor, as well as a docker container I am running.

I tried to also increase the plantuml limit size in docker with no success.

UML source

@startuml
package "A" {
component "B" {
portout p1
portout p2
' Commenting out p3 will get this to render
portout p3
}
}
'unrelated link, must be with label
C -> p4 : X
' If I uncomment this following link to the 3rd port, the image will render; BUT only if the link includes the label
' C -> p3 : Y
@enduml

Docker compose

version: '3.8'
services:
plantuml:
image: plantuml/plantuml-server:tomcat
ports:
- "8080:8080"
environment:
- PLANTUML_LIMIT_SIZE=16384
- JAVA_OPTS=-Xmx2g # Allocates up to 2GB of RAM to the Java process

Exception in docker

Exception java.lang.IllegalStateException

net.sourceforge.plantuml.dot.UnparsableGraphvizException: java.lang.IllegalStateException

at net.sourceforge.plantuml.svek.GraphvizImageBuilder.buildImage(GraphvizImageBuilder.java:294)

at net.sourceforge.plantuml.svek.CucaDiagramFileMakerSvek.getTextBlock(CucaDiagramFileMakerSvek.java:82)

at net.atmp.CucaDiagram.getTextBlock(CucaDiagram.java:480)

at net.sourceforge.plantuml.UgDiagram.getExporter(UgDiagram.java:121)

at net.sourceforge.plantuml.UgDiagram.exportDiagram(UgDiagram.java:93)

at net.sourceforge.plantuml.servlet.DiagramResponse.sendMap(DiagramResponse.java:321)

at net.sourceforge.plantuml.servlet.MapServlet.doGet(MapServlet.java:57)

at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:622)

at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:710)

at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:128)

at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)

at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:107)

at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:165)

at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:77)

at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:492)

at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:113)

at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:83)

at org.apache.catalina.valves.AbstractAccessLogValve.invoke(AbstractAccessLogValve.java:782)

at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:72)

at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:341)

at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:397)

at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:63)

at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:1272)

at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1801)

at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:52)

at org.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:946)

at org.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:480)

at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:57)

at java.base/java.lang.Thread.run(Thread.java:840)

Caused by: java.lang.IllegalStateException

at net.sourceforge.plantuml.svek.DotStringFactory.solve(DotStringFactory.java:358)

at net.sourceforge.plantuml.svek.GraphvizImageBuilder.buildImage(GraphvizImageBuilder.java:287)

... 28 more

Error image in plantuml running in docker

Answered: Swimlanes and simple repeat loop produce wrong result

Mon, 15 Jun 2026 14:50:40 +0000

Hi all,

From:

@startuml
|swimlane 1|
start

repeat
|swimlane 2|
  :read data;
|swimlane 1|
  :generate diagrams;
repeat while (more data?)

stop

@enduml

You can add a dummy label and obtain:

@startuml
|swimlane 1|
start

repeat
label dummylab
|swimlane 2|
  :read data;
|swimlane 1|
  :generate diagrams;
repeat while (more data?)

stop

@enduml

Enjoy,

Regards,
Th.

Syntax mistake in PlantUML Language Reference - 12.1 Complex Examples

Fri, 08 May 2026 18:55:22 +0000

The diagram does not match the provided uml/yaml. As written, it does not create the child elements of partridges:

partridges:
count: 1
location: "a pear tree"
turtle-doves: two

Should be (with spaces before count and location):

partridges:
count: 1
location: "a pear tree"
turtle-doves: two

Regex Subdiagram crashes PlantUML

Mon, 27 Apr 2026 18:04:38 +0000

This regex subdiagram crashes PlantUML, I am using a bundled with Pycharm version, but planttext and plantuml's online formatters crash the same.

Diagram:

@startuml
class A {
{{regex
title someRegex
^\s*(\d{4,5}-?\d{3,4}-?\d{1,2})
}}
}
@enduml

https://www.plantuml.com/plantuml/uml/SoWkIImgAStDuKhEIImkLd1KgEQghYvAJK-ju2h9BCb9LIZEpqqD0lFZOegrD69IgarqJ6jrxO4COnqJ2CDGnwXMawksbgkMoo4rBmLa7000

Answered: Class diagram duplicates packaged interface when referenced from another package

Wed, 15 Apr 2026 20:29:01 +0000

Duplicated of:

- https://forum.plantuml.net/20410/diagram-duplicates-packaged-interface-referenced-another

Answered: Class diagram duplicates packaged interface when referenced from another package

Wed, 15 Apr 2026 20:26:51 +0000

Hello A,

Here is a possible workaround:

@startuml
package "App" as App {
  interface Interface
}

package "Adapters" as Adapters {
  class A implements App.Interface
  class B
}

B --> Interface
@enduml

Regards,
Th.

Answered: @startuml not recognizing digraph (DOT) content after upgrade to 1.2026.0

Wed, 25 Mar 2026 13:31:21 +0000

We have to update our documentation.

You need to use @startdot / @enddot now.

Hope this helps!

Answered: Gantt-Diagram header with several lines doesn't work

Fri, 20 Mar 2026 12:48:00 +0000

Hello B.,

That is now fixed (observed on v1.2026.3+)

Regards,
Th.

Answered: Bar chart diagram can't have an entry with value 0

Wed, 18 Mar 2026 19:49:19 +0000

Hello L.,

Thanks for the report,

That is now fixed with last snapshot and on next release (1.2026.3).

Enjoy,
Regards,
Th.

Answered: Reporting a diagram as requested when PlantUML threw an exception

Wed, 18 Mar 2026 19:44:02 +0000

Hello F.,

See doc. here:

https://plantuml.com/elk

And use, on local, this plantuml version:

https://github.com/plantuml/plantuml/releases/download/v1.2026.2/plantuml-epl-1.2026.2.jar

See also current issues about webserver plantuml and ELK here:

Regards,
Th.

the -cypher commandline option doesn't work for new syntax

Fri, 13 Mar 2026 12:42:20 +0000

when using the cypher option on the commandline, the cypher engine doesn't detect some of the "newer" syntax, which ends up breaking the build. certain lines in component diagrams like "package my_package as mp" don't get cyphered, but their use will. also skinparam groups with the "<<myskin>>" don't get scrambled either.

ports are still pretty buggy.

Thu, 12 Mar 2026 21:10:37 +0000

ports for component diagrams have come a really long way; but for mild complexity diagrams, they are still failing to align properly.

GANTT: IllegalArgumentException because of constraints

Mon, 09 Mar 2026 12:02:58 +0000

Testet with V1.2026.3beta 4 and V1.2026.2.

I have the following Example which does not work:

@startgantt MWE
'--- Grund‑Einstellungen ----------------------------------------------------
Project starts 2026-03-23
saturday are closed
sunday are closed
2026-04-03 to 2026-04-06 is closed
2026-05-01 is closed
2026-05-15 is closed
2026-05-25 is closed
hide resources footbox
printscale daily zoom 5
title "MEW"
footer Stand: 09.03.2026
language de
today is colored in green
'-------------------------------------------------------
[First Todo] as [a1] on {Res A} starts at 2026-03-23 and requires 1 day
[Second Todo] as [a2] on {Res A} requires 1 hour and starts at [a1]'s start
[Third Todo] as [a3] on {Res A} requires 3 days and starts at [a2]'s end
@endgantt

If I change the yellow highlighted part to start, everything works fine.

Answered: commandline page not updated

Sun, 01 Mar 2026 10:54:45 +0000

Thanks for your contribution!

We have validated your modification, this will be online soon.

Thanks again!

Answered: Smetana "UNSUPPORTED" crash

Fri, 27 Feb 2026 22:35:17 +0000

OK, thanks for the report.

It is possible that version 1.2026.3beta1 fixes this issue.
Can you try it at https://github.com/plantuml/plantuml/releases/tag/snapshot

And tell us the result?

Thanks!

Answered: NullPointerException with 1.2026.1, works with 1.2025.10

Fri, 27 Feb 2026 08:54:49 +0000

Hello R.,

That is now fixed with the last snapshot (v1.2025.2+) here:

Releases · plantuml/plantuml

Thank for the report,
Regards,
Th.

Answered: IllegalStateException while attempting to rename nested state

Wed, 11 Feb 2026 19:37:09 +0000

Hello T.,

Here is the right syntax:

@startuml
hide empty description 

state "Toplevel state" as state1 {
state "This is the idle state" as idle
}
state state1.over
state1.idle --> state1.over

@enduml

Regards,
Th.

notes attached to class member useless if left to right direction

Tue, 10 Feb 2026 09:08:14 +0000

Note left or right of specific class members looks messy when using left to right direcion:

```
@startuml

left to right direction

class a {
field1
field2
field3
}

note right of a::field2
first field
end note

note left of a::field3
another field
end note

@enduml

compare to top to bottom direction:

Answered: Line on WBS diagram isn't straight

Tue, 20 Jan 2026 19:37:45 +0000

Hello E.,

For that add a space after "brussels", as:

FYI, that is due to the fact that the root is just on the middle.

Enjoy,
Regards,
Th.

Answered: Gantt: days off break tasks dependencies

Fri, 16 Jan 2026 18:48:22 +0000

Hello L.,

Due to the current Gantt engine:
- All constraints must be given first.

Then here is the good definition, by placing `day off` first, as:

@startgantt
hide resources names
{Alice} is off on 2026-01-19
[Task1] on {Alice} requires 5 days and starts 2026-01-15
then [Task2] on {Alice} requires 5 days
@endgantt

Enjoy,
Regards,
Th.

Answered: Crash observed when generating a SVG image from a Seqeunce Diagram with Embedded Salt

Fri, 16 Jan 2026 16:24:01 +0000

Hello G.,

Thanks for the report.

This should be resolved by:

Remove from sub-diagram SVG processing instructions by immortaldd · Pull Request #2478 · plantuml/plantuml

Could you test with last snapshot:

Release snapshot - JAR (~v1.2026.1beta2) · plantuml/plantuml

Regards,
Th.

Answered: Left constraint for self-transitions is not taken into account in state diagrams

Wed, 14 Jan 2026 13:02:20 +0000

[Just for the record]

See similar [old] requests here:

Regards,
Th.

The Gap - a freespace bug after extentending nodes in nwdiag

Fri, 26 Dec 2025 11:32:22 +0000

There is like,a gap between dev3 and DPx. Or maybe its a variation where gap is between web3 and PPx. Anyway I believe its a bug. I know the nwdiag is an [Amazing and totally not bugged out diagramm code] yet still I want to at least know how to workaround with this.

So, that is code:

@startuml

nwdiag {

group YProd{

web1

web2

}

group YDev{

dev1

dev2

}

group YUat{

uat1

uat2

}

network Public {

color = "red"

Q -- web1

web1 -- web2

web2 -- web3

vd -- dev1

dev1 -- dev2

dev2 -- dev3

vu -- uat1

uat1 -- uat2

uat2 -- uat3

vg1

vg1 -- git1

vg2

vg2 -- git2

}

network Private {

color = "palegreen"

width = full

web3 -- PPx

uat3

dev3 -- DPx

DPx -- Ddb

PPx -- Pdb

git1

git2

}

@enduml

Rendering error on Mac (M2) - externally imported library

Fri, 12 Dec 2025 13:57:41 +0000

Error, inside IntellJ. Local rendering. Switching to remote rendering works fine. Code below. Also works on collegues computer. Other diagrams work well, so my guess is that it might be in the included library, but instruction in error tells me to post here. Reported also at https://github.com/tmorin/plantuml-libs/issues/38.

@startuml

!global $LIB_BASE_LOCATION="https://raw.githubusercontent.com/tmorin/plantuml-libs/master/distribution"
!include $LIB_BASE_LOCATION/bootstrap.puml

' loads the package bootstrap
include('eventstorming/bootstrap')

' include elements
include('eventstorming/Element/FacadeCommand')
include('eventstorming/Element/Command')
include('eventstorming/Element/Result')
include('eventstorming/Element/Event')
include('eventstorming/Element/DomainEvent')
include('eventstorming/Element/IntegrationEvent')
include('eventstorming/Element/Query')
include('eventstorming/Element/ReadModel')
include('eventstorming/Element/UserInterface')
include('eventstorming/Element/Aggregate')
include('eventstorming/Element/Service')
include('eventstorming/Element/Policy')
include('eventstorming/Element/Saga')
include('eventstorming/Element/Process')
include('eventstorming/Element/Timer')
include('eventstorming/Element/Person')
include('eventstorming/Element/System')
include('eventstorming/Element/Comment')


' display elements
FacadeCommand('FacadeCommand')
Command('Command')
Result('Result')
Event('Event')
DomainEvent('DomainEvent')
IntegrationEvent('IntegrationEvent')
Query('Query')
ReadModel('ReadModel')

@enduml

Embedded dot generates broken svg

Thu, 04 Dec 2025 17:04:37 +0000

Hello,

What I do :

The following source test.puml :

@startuml
digraph dfd{
problem -> solution [label = "é"]
}
@enduml

Rendered, under windows with he command :

javaw -jar plantuml.jar -charset UTF-8 -tsvg test.puml

Notepad++ indicates my file is encoded in utf8.

What happen :

the generated svg is broken : the first line in the svg is not compliant with xml, it looks like a dot error message :
"Warning: Invalid 3-byte UTF8 found in input of graph dfd - treated as Latin-1. Perhaps "-Gcharset=latin1" is needed?"

Yet, after removing this line, the svg is correct, the content is also correct : the "é" is here.

Result is the same with png format.

Using :

dot is the dot embedded in plantuml version plantuml-1.2025.10 on Windows 11.

Further test :

I run similar test with a later dot version using

$env:GRAPHVIZ_DOT="C:\Dev\Outils\Graphviz\bin\dot.exe"

javaw -jar plantuml.jar -charset UTF-8 -tsvg test.puml

with the same result.

What I expect :

I think that if there is an error, no output should be generated at all, at least not an invalid output (a valid svg with the error message)

I think all the input is UTF8, so I think that there should be no error at all.

Regards,

PMZ

Goto operator doesn't work if swimlanes used

Mon, 17 Nov 2025 04:37:44 +0000

(just added two swimlanns to example with 'goto')

@startuml
title Point two queries to same activity\nwith `goto`
|swimlane1|;
start
if (Test Question?) then (yes)
'space label only for alignment
label sp_lab0
label sp_lab1
'real label
label lab
:shared;
else (no)
if (Second Test Question?) then (yes)
label sp_lab2
goto sp_lab1
else
|swimlane2|;
:nonShared;
endif
endif
:merge;
@enduml

Strange behaviour in percentage of completion of Gantt diagram

Wed, 12 Nov 2025 11:25:08 +0000

Hello, PlantUMLers!

Playing with a Gantt diagram, I discovered that this (minimal working example) code

@startgantt
<style>
ganttDiagram {
    task {
        RoundCorner 1
    }
}
</style>

Project starts 2025-10-06
saturday are closed
sunday are closed
[Task] as [task] requires 20 days and is colored in lightblue 
[task] is 15% complete
@endgantt

generates this diagram:

As you can see, the % of completion (wrongly) appears at the beginning of each segment, with exception of the first and last one.

If I remove "RoundCorner 1" or set it to 0, it works well:

And even stranger... If I keep "RoundCorner 1" but remove "Project starts 2025-10-06", it also works well!

I think this is a bug but in case it is not, is there something I am doing wrong?

Thanks in advance!

Answered: error with online plant uml

Tue, 11 Nov 2025 09:31:21 +0000

Well, what do you copy and where exactly? How big is the diagram text? Have you tried the command-line version plantuml.jar?

We cannot debug a problem with insufficient details.

Answered: picoweb port default is no more 8080

Mon, 03 Nov 2025 18:44:17 +0000

Thanks for the report!

This is restored with last commit https://github.com/plantuml/plantuml/commit/c5367aaf31217ab577c721b3f4bb59b6ad6e4432

Answered: lifeline deactivate not work

Wed, 22 Oct 2025 06:57:23 +0000

Hello L.,

Here is a workaround:

@startuml
Entity PKG
Entity MMU
Boundary TDB
Boundary RDB

PKG -> MMU : 1
activate PKG
activate MMU
MMU -> PKG : 2
deactivate MMU
PKG -> TDB : Send Packet
deactivate PKG
activate TDB

TDB -> RDB : Send Packet
deactivate TDB
activate RDB
deactivate RDB
@enduml

And FYI the last `deactivation` is just ignored.

Regards,
Th.

Answered: Qualified associations with left to right direction

Mon, 20 Oct 2025 07:33:39 +0000

In addition, `left to right direction` reverses the "note" position on packages: notes placed as bottom, goes on top of the package. and viceversa.

@startuml
left to right direction
package PACK1  {
  usecase TEST1
}
usecase TEST2
note bottom of PACK1
   A note bottom of PACK1.
endnote
note bottom of TEST2
   A note bottom of TEST2.
endnote
@enduml

Answered: Version 1.2025.5 on Windows gives error "java.lang.UnsupportedOperationException: Compression not supported."

Tue, 14 Oct 2025 16:02:18 +0000

On certain JVMs (notably on Windows Server 2022 runners), the call to configure compression mode and quality could throw an exception, which caused the crash you observed.

This was fixed in https://github.com/plantuml/plantuml/commit/d3fdcbd5a2fc575375c1d687806bed61f4c25355 by wrapping the compression configuration in a try/catch block.

This change ensures that if the JVM or image writer does not support explicit compression settings, PlantUML logs a warning instead of failing.
That explains why the problem disappears in 1.2025.8 and also why it only affected specific environments.

Using a try/catch around the compression settings isn't a great solution, but it works in practice.

Answered: WBS - Use multiline text with "Change direction" feature

Wed, 24 Sep 2025 17:27:11 +0000

Hi B.,

Thank for the report.

With next release (v1.2025.8), it will be now fixed:

@startwbs
* Root
**<:Line 1
Line 2;
**>:Line 3
Line 4;
@endwbs

Enjoy,
Regards,
Th.

Answered: PlantUML crash report

Sat, 20 Sep 2025 19:48:39 +0000

Yes, that is the problem I raised the topic about. Thanks for creating the github issue :) I will track that

Answered: diagram for book Agentic Design Patterns: Building Intelligent Systems

Wed, 10 Sep 2025 16:34:41 +0000

Hi V.,

Here is the fixed version (without any actor) of the Activity diagram:

@startuml
skinparam style strict
skinparam activityBorderThickness 1
skinparam activityArrowColor #185E8A
skinparam activityDiamondBackgroundColor #D3D3D3
skinparam activityEndColor #FF6347
skinparam activityStartColor #7FFF00
skinparam activityBackgroundColor #F0F0F0
skinparam defaultTextAlignment center
skinparam componentStyle rectangle

title Important Agentic Steps and Sequencing

'actor User

start

:User provides **Prompt** (Get the Mission); [1]
note right
  The user initiates the AI agent's workflow by giving it a goal.
end note

partition "AI Agent Core Loop" {
  :Agent **Scans the Scene** (Gathers relevant information); [1]

  partition "Phase: Think It Through" {
    :Agent **Formulates a Plan** (Planning Pattern); [2, 3]
    note
      Decomposing complex goals into a sequence
      of smaller, actionable steps.
    end note

    split
      '--- Pathway 1: Linear Execution (Prompt Chaining) ---
      :Execute **Prompt Chain** (Step 1); [4, 5]
      -> :Execute Prompt Chain (Step 2 - uses previous output);
      -> :Final Chain Step;
    split again
      '--- Pathway 2: Conditional Logic (Routing) ---
      :Apply **Routing Logic** (Evaluate criteria); [6, 7]
      if ("Condition Met?") then (Yes)
        -> :Route to Specialized Path A;
      else (No)
        -> :Route to Specialized Path B;
      endif
    split again
      '--- Pathway 3: Concurrent Operations (Parallelization) ---
      fork
        :Perform **Parallel Task X** (e.g., Tool Use 1); [8-10]
      fork again
        :Perform **Parallel Task Y** (e.g., Tool Use 2); [8-10]
      end fork
      -> :Aggregate Parallel Results;
    split again
      '--- Pathway 4: Iterative Improvement (Reflection) ---
      :Generate Initial Output;
      :Critique Output; [11]
      repeat
        :Refine Output based on Critique; [12]
        :Re-Critique Refined Output;
      backward :Refine Output based on Critique;
      repeat while ("Not Optimal")
      -> :Optimal Output Achieved;
    end split
    
    :Synthesize & Finalize Internal Logic;
  }

  partition "Phase: Take Action" {
    :Agent Executes Plan\n(Involving **Tool Use** or Multi-Agent Collaboration); [1, 10, 13-15]
    note
      Utilizes external APIs, databases, or
      delegates to other agents to achieve the goal.
    end note
  }

  :Agent **Learns & Gets Better** (Adapts for future tasks); [1, 16]
  note
    Continuously improves its performance,
    strategies, and knowledge.
  end note
}

:Deliver Final Output to User;
'User <- (Final Output to User)

stop
@enduml

Enjoy,

Regards,
Th.

Answered: Windows png rendering not working for dot files

Sat, 06 Sep 2025 18:47:38 +0000

Unfortunately, PNG generation is not supported on Windows for DOT-based diagrams in PlantUML. Sorry about that.

java.lang.IllegalArgumentException on generating diagram in IntelliJ IDE

Fri, 05 Sep 2025 16:07:25 +0000

I have a C4 plantUML diagram that works fine with plantUML.com but when trying to generate using IntelliJ plug-in it gives error: "java.lang.IllegalArgumentException "

@startuml
!include <C4/C4_Container>
!define DEVICONS https://raw.githubusercontent.com/tupadr3/plantuml-icon-font-sprites/master/devicons
!include DEVICONS/database.puml
!include DEVICONS/apple.puml
!include DEVICONS/android.puml

skinparam diagramBorderColor black
skinparam diagramBorderThickness 3

<style>
document {
  Margin 10
}
</style>
AddElementTag("dataStore", $bgColor="white", $fontColor="black", $legendText="Data Store")
AddPersonTag("userColor", $bgColor="#B3E4FC", $fontColor="#036FA5")
AddPersonTag("adminColor", $bgColor="#FCD9B3", $fontColor="#A55C03")
AddBoundaryTag("paypalBoundaryColor", $bgColor="#E3F4FF", $borderColor="#ADD8E6", $legendText="PayPal Boundary")
AddBoundaryTag("aprilBoundaryColor", $bgColor="#F3E3FF", $borderColor="#D8B6FF", $legendText="April Boundary")

Person(user, "PayPal User", "End user accessing the tax flow", $tags="userColor")

System_Boundary(paypalBoundary, "PayPal Systems", $tags="paypalBoundaryColor") {
    Person(admin, "PayPal Admin (CS Agent)", "Customer support/admin", $tags="adminColor")
    Container(paypalApp, "PayPal\nApp / Web", "Frontend")
    Container(graphQL, "CFS GraphQL Service", "")
    Container(TaxOrch, "Tax Orchestration Service", "Raptor Service")
    Container(CFSOrch, "CFS Orchestration Service", "Raptor Service")
    Container(alpService, "ALP Platform", "Product Subscription")
    Container(commService, "Communication Platform", "Notification Service")
    Container(taxService, "TAX/Reporting Platform", "Tax Service")
    ContainerDb(paypalSOR, "PayPal SOR", "CFSYS", "Oracle", $sprite="database", $tags="dataStore")
    Container(paypalRPS, "RPS Platform", "RPS")
    Container(paypalMarketing, "Marketing Email Platform", "PayPal")
    Container(paypalWebhookListener, "Webhook Listener", "Raptor Service")
    ContainerDb(paypalMessageQueue, "Message Queue", "QUEUE", $sprite="database", $tags="dataStore")
    Container(paypalMessageSubscriber, "Message Subscriber", "Raptor Service")
}

System_Boundary(aprilBoundary, "April Systems", $tags="aprilBoundaryColor") {
    Container(aprilAPI, "April API", "REST API")
    Container(aprilWebhook, "April Webhook Service", "Webhook Publisher")
}

Lay_R(user, paypalApp)
Lay_R(CFSOrch, alpService)
Lay_R(alpService, taxService)
Lay_R(taxService, paypalSOR )

Rel(admin, TaxOrch, "Reads the customer tax current status")
Rel(user, paypalApp, "Login to PayPal")
BiRel(paypalApp, graphQL, "Check for DD Account & load April iFrame")
BiRel(graphQL, TaxOrch, "Check Production Subscription & Call April API to get access token")
Rel(TaxOrch, CFSOrch, "Check if customer has Direct Deposit Account")
Rel(TaxOrch, alpService, "Check and Subscribe user to Embedded Tax Filing Product")
Rel(TaxOrch, aprilAPI, "April API Calls")
BiRel(TaxOrch, paypalSOR, "Fetch & update current status")
Rel(TaxOrch, paypalRPS, "Update RPS attribtues based on estimator/filing statuses")
Rel(TaxOrch, taxService, "Fetch the 1099K/INT tax documents")
Rel(paypalMarketing, paypalRPS, "Fetch estimator/filing segments to send marketing emails")
Rel(paypalMarketing, commService, "Send push notifications")
Rel(aprilWebhook, paypalWebhookListener, "April sends webhook events for status change")
Rel(paypalWebhookListener, paypalMessageQueue, "Queue the webhook received for Async processing")
Rel(paypalMessageQueue, paypalMessageSubscriber, "De-Queue the webhook event for processing")
Rel(paypalMessageSubscriber, TaxOrch, "Process webhook event")
BiRel(aprilWebhook, aprilAPI, "")
SHOW_LEGEND()
@enduml
"

Answered: comment placement causes a diagram to fail; is this a bug?

Fri, 01 Aug 2025 10:44:16 +0000

Hello F.,

That is currently the normal behaviour.

Answered: Text of delay message in cerulean theme is invisible

Sun, 06 Jul 2025 09:40:36 +0000

Hello C.,

That is now fixed with last version v1.2025.4:

@startuml themetest
!theme cerulean
title Theme test
Actor "Mr. A" as A
Actor "Ms. B" as B
A -> B : Test A to B
... Test wait...
==Test Break==
@enduml

Enjoy,
Regards,
Th.

Answered: CSS styling Beta - Sequence diagram - dots not colored with LineColor

Fri, 04 Jul 2025 17:16:44 +0000

Hello A.,

With last version v1.2025.4, we can now have:

@startuml

<style>
sequenceDiagram {
    LineColor #0c0
    LineThickness 3
}
</style>

participant X

...

@enduml

Enjoy,
Th.

Answered: Lifeline border thickness is ignored when a delay is added in sequence diagram

Fri, 04 Jul 2025 17:13:09 +0000

Hello A.,

With last version v1.2025.4, we can now have:

<style>
element {
LineThickness 3
}
</style>

participant A

[-> A
...
[<-- A

Enjoy,
Regards,
Th.

Answered: Syntax error with very long message in sequence diagram when preceded by separator

Wed, 02 Jul 2025 10:47:56 +0000

Hello S.,

In fact, it is not due to 'separator' because without it is a Class diagram (not a Sequence diagram!):

Then the issue is due to the Sequence Diagram message constraint and length limit (currently max size is 2000).

See similar request here:

https://github.com/plantuml/plantuml/issues/1013

Ref.:

Regards,
Th.

Answered: "material" stdlib is not working in the current version ("IOException stream closed")

Tue, 24 Jun 2025 07:46:13 +0000

Hello K.,

For old material stdlib, we must now use `material2.1.19`:

@startuml
!include <material2.1.19/common>
' To import the sprite file you DON'T need to place a prefix!
!include <material2.1.19/folder_move>

MA_FOLDER_MOVE(Red, 1, dir, rectangle, "A label")
@enduml

See:

plantuml/plantuml-stdlib: Contains official Standard Library for PlantUML

See also breaking news (with breaking of backwards compatibility) with this PR here:

update `material` (to point out to latest SVG `material` stdlib) · Pull Request #142 · plantuml/plantuml-stdlib

Regards,
Th.

JSON block fails in VSCode extension preview

Fri, 20 Jun 2025 10:39:58 +0000

This diagram fails to render in the VSCode extension (v2.18.1) preview, but exports ok with the same server.

Server: Docker (0967a1317791 - Jetty)
Tomcat also fails but doesn't give error info (Jetty call stack available if needed).

Diagram:
@startuml

json "jsonBlock" {

"a": "b"

}

@enduml

Answered: Parsing Error (Assumed diagram type: sequence) for Basic Activity Diagram Syntax in Version 1.2025.4beta2 and 1.2025.3

Thu, 19 Jun 2025 04:53:27 +0000

Hello P.,

Where do your examples come from

Because first the word `activity` is not a PlantUML keyword!

Where do your uses come from?

FYI, those minimal examples are first invalid on PlantUML:

@startuml
activity "Test Activity" 
@enduml

@startuml
activity "Test Activity" as TA
@enduml

Idem for :"Test"; it is for Activity Diagram, like:

:a;
:b;
:c;

If that can help,

Regards,
Th.