# Feature OP-13745 - Improve work package shortcodes discoverability and UX

Project: OpenProject
Status: new
URL: https://community.openproject.org/work_packages/OP-13745

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | Wish List |
| Sprint |  |
| Backlog bucket |  |
| Votes | 1 |
| List |  |
| 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 |  |
| 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 |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

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

## Description

**As a** user of OpenProject

**I want to** understand and easily use work package (and other resources) short codes

**so that I** do not have to manually type, search for IDs, and remember which codes stand for what aspect.

The current integration of work package short codes (\#, \#\#, \#\#\#) into CKEditor is bad and broken. It is not discoverable. We will be looking into a solution that involves something like slash commands or other autocompleters that will help users understand how to use the feature.

> ### Original bug report
> 
> *Please write down the steps to reproduce. Try to write down all necessary preconditions (what permissions do you have, are other users involved?). Example:*
> 
> 1.  Type \#\#\# and the work packege number or select a work package from the pulldown menu.
> 2.  The displayed result will be this, regardless of the number of \# you typed in: \#<mention class="mention" data-id="1213" data-type="work_package" data-text="#1213">\#1213</mention> The system will only use the first \#.
> 
> ### What is the expected behavior?
> 
> *Describe how the application should behave like. Example:*
> 
> 1.  The result when using ### should display more information: <mention class="mention" data-id="123" data-type="work_package" data-text="###123">###123</mention>
> 
> ## 
> 
> ## **Work around that works at the moment:**
> 
> 1.  Type in the \#\#\# followed by the ticket ID.
> 2.  Ignore the pulldown and save the changes.
> 3.  The result will be shown as expected.
> 
> ### Environment information
> 
> *Please check and fill out the following details to help us identify in what versions and distributions of OpenProject the error occurs*
> 
> **OpenProject installation type**
> 
>   - \[x\] Packaged installation
>       - What distribution? Enterprise edition  13.0.6
> 
> **OpenProject version**
> 
> *If you're not running on the cloud edition, please specify the version of OpenProject you're running. Example: v12.1.5*
> 
> **Browser**
> 
>   - \[ \] Chrome
>   - \[x\] Firefox
>   - \[ \] Safari
>   - \[ \] Mobile Safari
>   - \[ \] Other (please specify)
> 
> **Language**
> 
> *Please specify the browser language and the language of the OpenProject user for which the bug occurred.*
> 
> German
