Add Universal Processing Notation (UPN) Shape Library
@egrimate is already working on this.
Since Jul 27, 2026.
Assessment
This issue has not been assessed yet.
Description
- I agree to follow the [Code of Conduct](https://github.com/jgraph/drawio/blob/dev/CODE_OF_CONDUCT.md) that this project adheres to.
- I have searched the issue tracker for a feature request that matches the one I want to file, without success.
Is your feature request related to a problem? Please describe.
draw.io supports many diagramming standards (UML, BPMN, flowcharts, etc.) but lacks support for Universal Process Notation (UPN). UPN is an open, nonproprietary process mapping standard originally developed in the early 2000s and released as an open standard in 2008. It is designed to be simple enough for anyone to use, not just process analysts, and is today supported by and embedded in many enterprise software programs. Teams that use UPN currently have no native shape library in draw.io and must manually construct activity boxes from grouped shapes, which is tedious and produces inconsistent results.
This was previously requested in #1031 but was declined, in part due to the lack of a suitable licensed icon set. This proposal addresses that concern directly: the implementation uses no external icons or image assets. All shapes are rendered programmatically using canvas drawing operations (rectangles, lines, circles, text), so there are no licensing dependencies. Everything is Apache 2.0 compatible.
Describe the solution you'd like
A UPN shape library in the sidebar palette containing:
- Activity Box - A single shape divided into three sections: WHAT (activity description), WHO (responsible resources), and SYSTEM (tools used)
- Flow Lines - Labeled connectors between activities describing WHY the next step occurs
- RASCI role badges - Programmatically rendered visual indicators on resources showing their role (Responsible, Accountable, Supportive, Consulted, Informed)
- Drill-down support - UPN's hierarchical process decomposition can be achieved by using draw.io's built-in link feature on activities to navigate to sub-process pages within the same document
Describe alternatives you've considered
- Using BPMN shapes as a substitute, but BPMN is significantly more complex and doesn't map well to UPN's simplicity
- Building UPN diagrams manually from basic shapes, which works but is slow, inconsistent, and loses semantic meaning
- Distributing a custom library via
Extras > Configuration(similar to [drawIo-Salesforce](https://github.com/ehsky/drawIo-Salesforce)), which covers basic shapes but cannot support programmatic features like RASCI badge rendering
Additional context
I have a working implementation ready in my fork that i will link in a bit: https://github.com/ehsky/drawio
All rendering is done programmatically. No external icons, fonts, or image assets are required. Happy to open a PR if there is interest.
UPN references:
- [Universal Process Notation - TechTarget](https://www.techtarget.com/searchcio/definition/Universal-Process-Notation-UPN)
- [What is UPN - Netcall](https://www.netcall.com/blog/what-is-upn/)
- [UPN Quick Start Guide (PDF) - Imperial College London](https://www.imperial.ac.uk/media/imperial-college/administration-and-support-services/operational-excellence/public/Quick-Start-Guide-to-Universal-Process-Notation.pdf)
- [Understanding UPN - Salesforce Trailhead](https://trailhead.salesforce.com/content/learn/modules/business-process-mapping/understand-universal-process-notation)
- Dominant language
- JavaScript
- Stars
- 9.4k
- Forks
- 1.4k
- PR merge metrics
- No merged PRs in 30d
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from jgraph/drawio
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Requesting a VPAT for app.diagrams.netPossibly taken @alderg claimed this 24 days ago. Openenhancement
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
-
enhancement
Difficulty 3/5 1-2 days Newbie friendliness 68/100
-
Import TablesOpenenhancement possible-duplicate
Difficulty 4/5 3-5 days Newbie friendliness 35/100
Similar issues
-
Difficulty 1/5 Under an hour Newbie friendliness 62/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 Under an hour Newbie friendliness 82/100
Leonxlnx/taste-skill#216 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
all-contributors/cli#690 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
area: ui Bug Payload OSS
Difficulty 1/5 Under an hour Newbie friendliness 88/100
payloadcms/payload#19839 ·
Maintainers usually reply within 1 day