# Feature COMMS-661 - Allow inline Work Package links within text paragraphs in the Documents module

Project: Stream Communicator
Status: closed
URL: https://community.openproject.org/work_packages/COMMS-661

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 17.5.0 |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Use cases

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| COMMS-806 | Bug | Documents: impossible to delete characters with backspace after adding a wp link | closed |  | 17.7.0 |  | Modules and project features / Documents, Modules and project features / Text editor / BlockNoteJS / OpenProject Extensions |
| COMMS-812 | Bug | Documents: work package link text and surrounding text not vertically aligned | confirmed |  | Product Backlog |  | Modules and project features / Documents, Modules and project features / Text editor / BlockNoteJS / OpenProject Extensions |

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups | https://www.figma.com/design/d3zhm0R0pjHJvQd3XTlxuS/New-Documents-module?node-id=3051-695 |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

As a document editor  
I want to insert links to Work Packages inside a text line or paragraph  
so that I can reference Work Packages naturally within the flow of text instead of placing them as standalone blocks.

**Acceptance criteria**

Work Package links can be inserted inside a text line without forcing a line break.

Text can exist before and after the Work Package link within the same paragraph.

Existing block-style Work Package links continue to work as before.

Inline Work Package links behave like regular inline elements (similar to standard hyperlinks) within the editor.

Clicking an inline Work Package link still opens the Work Package in a new tab.

Inline links maintain correct formatting and do not break the surrounding text layout.

**Technical notes**

Update the Work Package link component to support both **block** and **inline** rendering modes.

Modes:  
\- <mention class="mention" data-id="72817" data-type="work_package" data-text="#72817">\#72817</mention> 

<mention class="mention" data-id="72817" data-type="work_package" data-text="##72817">\#\#72817</mention>

<mention class="mention" data-id="72817" data-type="work_package" data-text="###72817">\#\#\#72817</mention>

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p"><strong>Mode</strong></p></td><td class="op-uc-table--cell"><p class="op-uc-p"><strong>Inline/Block?</strong></p></td><td class="op-uc-table--cell"><p class="op-uc-p"><strong>Data shown of work package</strong></p></td><td class="op-uc-table--cell"><p class="op-uc-p"><strong>Legacy notation</strong></p></td><td class="op-uc-table--cell"><p class="op-uc-p">In scope of this FEATURE</p></td><td class="op-uc-table--cell"><p class="op-uc-p"><strong>Caption in drop down (T-Shirt)</strong></p></td><td class="op-uc-table--cell"><p class="op-uc-p"><strong>Descriptive Caption</strong></p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">XXS</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Inline</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Identifier</p></td><td class="op-uc-table--cell"><p class="op-uc-p">#</p></td><td class="op-uc-table--cell"><p class="op-uc-p">✅&nbsp;</p></td><td class="op-uc-table--cell"><p class="op-uc-p">XXS - Identifier</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tiny - Identifier</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">XS</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Inline</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Type, Identifier, Subject</p></td><td class="op-uc-table--cell"><p class="op-uc-p">##</p></td><td class="op-uc-table--cell"><p class="op-uc-p">✅</p></td><td class="op-uc-table--cell"><p class="op-uc-p">XS - Type, Identifier, Subject</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Compact - Type, Identifier, Subject</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">S</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Inline</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Status, Type, Identifier, Subject</p></td><td class="op-uc-table--cell"><p class="op-uc-p">###</p></td><td class="op-uc-table--cell"><p class="op-uc-p">✅</p></td><td class="op-uc-table--cell"><p class="op-uc-p">S - Status, Type, Identifier, Subject</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Regular &nbsp;- Status, Type, Identifier, Subject</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">M</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Block</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Identifier, Subject, Type, Status</p></td><td class="op-uc-table--cell"><p class="op-uc-p">n/a</p></td><td class="op-uc-table--cell"><p class="op-uc-p">✅</p></td><td class="op-uc-table--cell"><p class="op-uc-p">M - Status, Type, Identifier, Subject</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Compact card - Status, Type, Identifier, Subject</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">L</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Block</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Identifier, Subject, Type, Status, Parent, Project</p></td><td class="op-uc-table--cell"><p class="op-uc-p">n/a</p></td><td class="op-uc-table--cell"><p class="op-uc-p">❌&nbsp;</p></td><td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Regular card - Identifier, Subject, Type, Status, Parent, Project</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">XL</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Block</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Identifier, Subject, Type, Status, Parent, Project, Description snippet</p></td><td class="op-uc-table--cell"><p class="op-uc-p">n/a</p></td><td class="op-uc-table--cell"><p class="op-uc-p">❌&nbsp;</p></td><td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td><td class="op-uc-table--cell"><p class="op-uc-p">Full card - Identifier, Subject, Type, Status, Parent, Project, Description snippet</p></td></tr></tbody></table></figure>

Ensure the editor schema allows the Work Package element to exist within paragraph nodes.

Verify that inline Work Package links behave correctly during copy/paste, editing, and cursor navigation.

<br>
