OpenProject is the leading open source project management software.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
openproject/docs/system-admin-guide/attribute-help-texts/README.md

88 lines
4.4 KiB

---
sidebar_navigation:
title: Attribute help texts
priority: 790
description: Learn how to set attribute help texts in OpenProject
robots: index, follow
keywords: attribute help texts, help texts for projects and work packages
---
# Attribute help texts (Premium feature)
<div class="glossary">
**Attribute help texts** provide additional information for attributes in work packages and projects. After setting them up they are displayed when users click on the question mark symbol next to custom fields in projects and work packages.
This way you will reduce wrong entries for attributes. This is especially relevant for company specific custom fields.
</div>
<div class="alert alert-info" role="alert">
**Note**: Attribute help texts are a Premium Feature and can only be used with [Enterprise cloud]( ../../cloud-edition-guide/) or [Enterprise on-premises](../../enterprise-edition-guide/). An upgrade from the free Community Edition is easily possible.
</div>
## Overview
| Topic | Content |
| ------------------------------------------------------------ | :--------------------------------------------------------- |
| [Adding Attribute help texts](#adding-an-attribute-help-text) | How to add and configure an Attribute help text. |
| [Editing or deleting Attribute help texts](#editing-or-deleting-attribute-help-texts) | How to edit and how to delete an Attribute help text. |
| [Work packages](#work-packages) | Where will Attribute help texts for work packages be used? |
| [Projects](#projects) | Where will Attribute help texts for projects be used? |
Navigate to -> *Administration* -> *Attribute help texts* to set up help texts for attributes and custom fields in work packages and projects. Here you can add, edit and delete Attribute help texts.
![image-20201006165832885](image-20201006165832885.png)
## Adding an Attribute help text
To add an Attribute help texts for custom fields click on the green **+ Attribute help text** button.
1. **Choose the attribute** you'd like to explain. Custom fields are also displayed here, which may require further explanation.
2. Add a **description**. You can add in-line pictures, links or videos, too. This **help text description** which will be shown in work package or project forms for the users.
3. Add **files**, e.g. excerpts from a process manual
4. **Save** your changes.
![image-20201006171019961](image-20201006171019961.png)
Be aware that the help text will be visible in all projects.
Once you configured the help text for an attribute, project members can see the explanation. The will see a question mark item next to the attribute.
When the users click on it, they see the description for this attribute.
![attribute help text description](image-20200122102249268.png)
## Editing or deleting Attribute help texts
Navigate to -> *Administration* -> *Work packages* -> *Attribute help texts* in order to edit or remove an attribute help text.
1. Click on the **name** of the attribute to edit an existing attribute help text.
2. Click on the **delete icon** to delete an attribute help text.
![Sys-admin-edit-delete-attribute-help-texts](Sys-admin-edit-delete-attribute-help-texts.png)
## Work packages
The Attribute help texts for work packages will be displayed in the [details view](../../user-guide/work-packages/work-package-views/#work-package-split-screen-view) (as in the screenshot below) and in the [full screen view](../../user-guide/work-packages/work-package-views/#work-package-full-screen-view). They will help the users (e.g. the project managers) understand what kind of information to put in which fields.
![Sys-admin-attribute-help-texts-open](Sys-admin-attribute-help-texts-open.png)
## Projects
The Attribute help texts for projects will be displayed in the Project details widget in the [Project overview](../../user-guide/project-overview/) (as in the first screenshot below) and in the [Project settings](../../user-guide/projects/project-settings/project-information/) (as in the second screenshot below).
They will help the users (e.g. the project managers) understand what kind of information to put in which fields.
![image-20201007112035870](image-20201007112035870.png)
![image-20201007112741049](image-20201007112741049.png)