# Feature OP-19745 - Optimise ARIA labels for inline page links and macros

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-19745

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 17.7.0 |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List | a11y report 2026 |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Modules and project features / Text editor / CKEditor5, Modules and project features / Work packages, Modules and project features / Text editor, Accessibility |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

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

## Estimates and progress

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

## Description

**Context**

Currently, inline work package macros (eg. <mention class="mention" data-id="71649" data-type="work_package" data-text="##71649">##71649</mention>) have a title tag to meta-describe what they are. These are not particularly useful to sighted users and add visual noise since they generate a tooltip on hover that says: "This text segment is dynamically rendered by a macro."

**Requirement**

Please implement this *after <mention class="mention" data-id="70554" data-type="work_package" data-text="##70554">##70554</mention>* is implemented, so that the ARIA labels can be added to the new Wiki page links too.

**Acceptance criteria**

  - Remove the title tag from all existing macros and page links

  - Replace with an ARIA label that describes the content a bit more precisely:
    
      - For work package links (eg. generated by \#, \#\# or \#\#\#): "A dynamic link to a work package placed using a macro"
    
      - For work package attributes (eg. generated by `workPackageValue:1234:assignee`): "A dynamic work package attribute placed using a macro"
    
      - For Wiki page links (eg. generated by using an XWiki macro): "A dynamic link to a wiki page placed using a macro"

**Translation strings**

These are new strings.

**Technical considerations**

\-

**Out of scope**

  - Accessibility of BlockNote-based inline- and block-level page links will be handled in <mention class="mention" data-id="73936" data-type="work_package" data-text="##73936">\#\#73936</mention>.

<br>
