Make a template easy to find
A template nobody finds never gets started. Members look for templates in two ways: they type in Search templates, or they pick a Purpose and scan that group. Search reads a template's name, summary, brief and group, and the name counts the most. This page shows how to word and file one of your organization's templates so it turns up in both. What a template carries is in How templates work.
Who can do this: your plan must include the Templates (org) feature, and you need permission to edit templates, which Org Owners and Admins hold (or a custom role that grants it). Without both, the gallery shows no Manage. Official templates are Jaah's own and only Jaah changes them.
- Ask two or three teammates what words they would type to find this kind of task, for example "flaky test" or "dependency upgrade". You will put those words in the next steps.
- Open Settings in the sidebar, then Templates under Customize, and select Manage. On Manage templates, find the template with the search box and select its row. Its editor opens on the Task tab.
- Open the Library tab and put the words people search for in the Name, since the name weighs most in search. Keep it short and plain: up to 80 characters.
- Choose the Purpose a member would browse to find it: Build & fix, Quality, Security, Maintenance, Docs & release or Research & planning. The template shows only in that group.
- Write the Summary as one line that says what the task produces, using a word or two that are not already in the name. Search reads it too.
- Optional: under Image, select Upload image (or Replace image) so the row stands out when people scan a group. Without one, the row shows its purpose's placeholder.
- Check that Status is Published. A Draft is hidden from the gallery, so no search finds it.
- Select Save.
- Back in the gallery, type each of the words from step 1 in Search templates. Matches show as one list, best match first. If the template sits low or does not show, add the missing word to its name, summary or brief on the Task tab, and save again.
To see whether people start it more afterwards, read its Starts count as in See which templates get started most.
Related
- Find a template in the gallery: how members search and filter the gallery.
- Templates: every field of the template editor and the Manage templates list.
- Give a template a gallery picture: upload, replace or remove the row's picture.