# Bug OP-15134 - Project attributes: Fix phrasing of "required" and "visible" options

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

## Open points

_No work packages_

## Details

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Module |  |
| Target versions | 14.5.0 |
| Observed in versions | 14.1.0 |
| Sprint | 14.5.0 |
| Backlog bucket |  |
| Bug found in version (deprecated) | 14.1.x |
| Found in mobile app version |  |
| Follow-up feedback e-mail |  |
| Requires doc change | Yes |
| Accessibility | No |
| Pull preview |  |
| List |  |
| Labels |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable | Attila Dombi |
| Product manager |  |
| Developers |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Planning

| Attribute | Value |
| --- | --- |
| Relevance |  |

## Costs

| Attribute | Value |
| --- | --- |
| Votes |  |
| Work |  |
| Labor costs |  |

## Description

###  Steps to reproduce

1.  Go to Administrator Settings → Project → Project attributes

2.  Go to the edit page of a project attribute

### What is the buggy behavior?

  - The options "Required", "Visible", and "Searchable" are hard to understand

### What is the expected behavior?

  - **For project attributes only:**
    
      - Rename label "Required" to "Required for all projects"
        
          - Change hint text to: "Check to enable this attribute and make it required in all projects. It cannot be deactivated for individual projects."
        
          - This must only be changed for project attributes. 
    
      - For the "Searchable" form field:
        
          - Add hint text: "Check to make this attribute available as a filter in project lists."

  - **For all other custom fields (including spent time, versions, users, groups)**
    
      - Keep the same "Required" label and description.
    
      - Keep the existing description for the "Searchable" form field.
    
      - The column header in the work package custom fields table should remain "Required".

  - **For project attributes, custom fields and user custom fields:**
    
      - Rename "Visible" label to: "Admin-only"
        
          - Change hint text to: "Check to make this attribute only visible to administrators. Users without admin rights will not be able to view or edit it."
        
          - This must be changed for all custom fields: project attributes **and** user custom fields. This will fix <mention class="mention" data-id="56897" data-type="work_package" data-text="##56897">##56897</mention>.
        
          - Flip the behaviour so that :
            
              - unchecked by default now
            
              - you check to limit the visibility to admins instead of current behaviour where you check to make it visible to non-admins
        
          - Migrate so that the switch setting is flipped for all existing project settings

### Context

These project attribute and custom field edit pages can be improved a LOT more than this (and also Primerised), but this is a smaller incremental difference to improve usability/comprehension.

### Screenshots and other files

**Current phrasing:**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/105370/content">

### Environment information

**Edge**  
**OpenProject 14.2.0**

Core build  
[f33618987b77e72a08695d6f41b5695d5c8310a9](https://github.com/opf/openproject/commits/f33618987b77e72a08695d6f41b5695d5c8310a9)

Product version  
[fb2ecef25b5f93b1a451b6cfb76493447d1b8d74](https://github.com/opf/saas-openproject/commits/fb2ecef25b5f93b1a451b6cfb76493447d1b8d74)

**Language**

EN

**Note to QA:**

Apart from testing the new Project Attributes changes described above, some regression testing is also required. The regression testing involves the creation custom fields available through the `/custom_fields` path in the admin section. Currently available custom field types:

  - Work packages

  - Spent time

  - Versions

  - Users

  - Groups

Also the respecting of the new `admin_only` flag for all the custom fields that have it on their creation forms.

The `admin_only` flag is applied only to the **Project Attributes** and to the **User custom fields** only.