Updating card keywords

Card keywords are words, numbers or symbols that Mingle uses to create automatic links in cards and pages. When you're editing a card or page and you add any of these keywords, Mingle will automatically convert them to links when you save your changes.

Your project has a card keyword definition of:

You're editing the description for a card and want to create a link to card number 123. Type the following in the description to create a hyperlink to card 123:

#123

Most card keywords would have been created during initial project setup, but you may want to update card keywords if you find team members are using terms to describe cards that are not being converted to links. This may happen if you change a card property, e.g. if you change a card from Type = Defect to Type = Bug, you may want to add a new card keyword called 'bug'.

How to create and update card keywords

Sign in to Mingle as a project administrator and open the project you want to change (if you're not already working in the project).
Click the Project admin tab.

Mingle displays the Project settings page.

if you are logged in as a project team member, Mingle displays the Team page.
Click the Card keywords link.

Mingle displays the Card keywords page.
Type the keywords you would like Mingle to recognize and convert to links. Separate your keywords with a comma and a space.

In the above example, if you want to link to card 123 you can type:
```
#123
```
or
```
story 123
```
or
```
card 123
```
or
```
defect 123
```
or
```
bug 123
```
or
```
fixed 123
```
or
```
fix 123
```
and Mingle will automatically create a hyperlink to this card.
If you have integrated your source repository with Mingle, you may wish to check whether your card keywords pick up card numbers in existing commit messages (see below).
Click the Update keywords link.

Testing card keywords source repository integration

Before you begin, you must know the number of a card that has been referenced in a source commit message, e.g. Fixed bug 123.

Sign in to Mingle as a project administrator and open the project you want to change (if you're not already working in the project).
Click the Project admin tab.

Mingle displays the Project settings page.

if you are logged in as a project team member, Mingle displays the Team page.
Click the Card keywords link.

Mingle displays the Card keywords page.
Type the number of a card that you know has been referenced in a source commit message.
Click the Test button.

Mingle displays the last 10 changesets/revisions that match the current keywords for this story. If you get the results you expect, this means you've selected good card keywords and Mingle is picking them up in commit messages.

If you don't see any matches, or not as many as you would expect, try adding different keywords and repeating.
Don't forget to click the Update keywords link to save your card keywords if you haven't done so already.

Help documentation