Enable self-service management of custom libraries in Draw.io for Confluence Cloud using DRAWIOCONFIG.
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 8.2k
- Forks
- 1.2k
- PR merge metrics
- No merged PRs in 30d
Description
- I agree to follow the Code of Conduct 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.
We actively promote a self-serve model across our organisation. We are heavy users of Confluence Cloud and extensively rely on custom libraries and templates in draw.io Diagrams.
Currently, development teams can self-manage custom templates using the DRAWIOCONFIG space, which works well. However, custom libraries cannot be managed in the same way. Managing libraries requires Confluence Administrator privileges, which creates a bottleneck between development teams and Confluence administrators.
As a result, development teams must raise tickets and wait for admin intervention whenever a library update is needed. This introduces delays and runs counter to our self-service approach. We would like draw.io Diagrams to support managing custom libraries in the same way custom templates are managed within the DRAWIOCONFIG space, allowing permission-based, self-serve access for development teams.
Describe the solution you'd like
To provide proper context, here is a comparison of the current state and the desired behaviour.
What we have today
-
A dedicated
DRAWIOCONFIGspace used to host custom libraries and templates. -
The space contains the following folders by default:
- logs
- Configuration
- Libraries
- Templates
-
Uploading a custom template to the Templates folder makes it automatically available when creating a new Draw.io diagram, reducing the need for repeated uploads.
-
Uploading a custom library to the Libraries folder has no effect. (This is the issue we are trying to solve)
-
Uploading custom libraries via Confluence Administration portal makes them available in new Draw.io diagrams, but:
- This capability is restricted to Confluence Administrators.
- Developers must submit requests and wait for manual processing.
What we need
- Uploading a custom template to the Templates folder should continue to make it available by default when creating a new Draw.io diagram.
- Uploading a custom library to the Libraries folder should also:
- Automatically populate the library when creating a new Draw.io diagram.
- Function in the same way as templates do today.
This approach would allow development teams to independently manage both templates and libraries, which evolve frequently due to changing requirements and new features.
Describe alternatives you've considered
Due to the current limitations around custom libraries:
- Confluence administrators manually upload libraries via the Confluence Administration portal for each request.
- Developers already have permissions to manage templates within the
DRAWIOCONFIGspace, which works well. - However, granting Confluence Admin privileges to developers is not feasible, as permissions cannot be sufficiently scoped to only Draw.io configuration and would introduce unnecessary risk.
Additional context
For additional context, please find the screenshots of the configuration pages we are referring to below:
- The
DRAWIOCONFIGspace
- The configuration page to upload custom libraries
- Managing libraries and templates within the
DRAWIOCONFIGspace (when this feature is released)
Contributor guide
No contributing guide indexed for this repository
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.
Research direction
Start by tracing how the DRAWIOCONFIG space currently makes uploaded templates available and compare that flow with custom libraries managed through Confluence Administration. Confirm the required permission boundary and how new diagrams discover configuration content. Done means libraries uploaded to the Libraries folder behave like templates without requiring Confluence Administrator privileges.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- cloud, web-dev
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100