> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getray.info/llms.txt
> Use this file to discover all available pages before exploring further.

# Profile Customization

> The Profile Customization screen defines the custom fields on user profiles: add, reorder, activate or delete fields, choose each field's type (text, number, choice list, image, file, section title, description), make fields required or admin-only, and translate labels. Found under Administration → Profile Customization in the RAY admin portal.

## Summary

The **Profile Customization** screen in the RAY admin portal defines the organization's custom
**profile fields**: extra information on each user's profile, such as an employee number, a
nationality or an ID document. An admin adds fields, chooses each field's type, orders them, marks
them required or admin-only, and gives each field a label in every language the organization uses.
All changes are saved together with one **Save** button.

## Where to find the Profile Customization screen

* Menu: **Administration → Profile Customization** (Arabic: **إدارة ← تخصيص الملف الشخصي**)

## Who can access the Profile Customization screen

The Profile Customization menu entry is shown only to users with an **Admin** role that includes the
administration feature.

## Profile field settings

Each profile field is a card on the Profile Customization screen with these settings:

| Setting                  | Arabic label             | Meaning and rules                                                                                                                                                                                                                   |
| ------------------------ | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Field type               | —                        | The kind of field, chosen from a dropdown. See *Profile field types*.                                                                                                                                                               |
| **Entry Name**           | اسم الإدخال              | The field's label, one per organization language. Required in the language the portal is being used in. For a **Title** field the setting is called **New Section Name**; for a **Description** field it is called **Description**. |
| **Placeholder**          | عنصر نائب                | Hint text shown inside an empty field. Only for **Short Text**, **Long Text** and **Number** fields, and required for them in the current portal language.                                                                          |
| **Active**               | مفعّل                    | Whether the field is in use.                                                                                                                                                                                                        |
| **Required**             | مطلوب                    | The user must fill the field. Cannot be combined with **Filled By Admin Only**.                                                                                                                                                     |
| **Filled By Admin Only** | يُعبأ من قبل المسؤول فقط | Only staff fill this field; the user cannot. Cannot be combined with **Required**.                                                                                                                                                  |

**Required** and **Filled By Admin Only** are not shown for **Title** and **Description** fields.

## Profile field types

The field type dropdown includes the following types:

| Type                                | Extra settings                                                                                                                                                                |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Short Text**                      | **Placeholder**.                                                                                                                                                              |
| **Long Text**                       | **Placeholder**.                                                                                                                                                              |
| **Number**                          | **Placeholder**.                                                                                                                                                              |
| **Multiple selection**              | **Choices**: at least two choices, each translated. **Allow Multiple** lets the user pick several, with a maximum number of selections. **Add Another Choice** adds a choice. |
| **Date**, **Time**, **Date & Time** | None.                                                                                                                                                                         |
| **Location**                        | None.                                                                                                                                                                         |
| **Photos**                          | "Maximum number of images a user can upload", at least 1.                                                                                                                     |
| **Files**                           | "Maximum number of files a user can upload", at least 1, and "Maximum size for each file", between 5 MB and 50 MB.                                                            |
| **Videos**                          | None.                                                                                                                                                                         |
| **Title**                           | Only **New Section Name**. A section heading.                                                                                                                                 |
| **Description**                     | Only **Description**. A block of text.                                                                                                                                        |

## How to add a profile field

1. Open **Administration → Profile Customization**.
2. Click **Add**. A new field card is added.
3. Choose the field type.
4. Enter the **Entry Name** in each language, and the **Placeholder** if shown.
5. Set **Required** or **Filled By Admin Only** if needed, and the type's extra settings.
6. Click **Save**.

A new field starts as a **Short Text** field with **Active** ticked and **Required** and **Filled By
Admin Only** unticked.

## How to reorder profile fields

Drag a field card by its handle to a new position, then click **Save**.

## How to delete a profile field

Click the delete (bin) button on the field card, then click **Save**. The field is only removed when
**Save** is clicked. To stop using a field without deleting it, untick **Active** and save.

## Saving profile fields

All changes on the Profile Customization screen, including new fields, edits, reordering and
deletions, are saved together by the **Save** button at the top. **Save** stays disabled until
something has changed and while any field is incomplete, for example a missing label.

## Common questions about profile fields

### How do I make a field mandatory for tenants?

Tick **Required** on the field and click **Save**. A field cannot be both **Required** and **Filled
By Admin Only**.

### How do I store information that tenants should not edit?

Tick **Filled By Admin Only** on the field and click **Save**. Only staff can fill that field.

### How do I add a dropdown with several options?

Add a field, choose the **Multiple selection** type, and enter at least two **Choices**. Tick
**Allow Multiple** to let users pick more than one.

### Why is the Save button disabled?

**Save** is disabled when nothing has changed or when a field is missing required information, such
as its **Entry Name** or, for **Short Text**, **Long Text** and **Number** fields, its **Placeholder** in the current portal
language.

## Related pages

* [Organization Settings](/administration/organization-settings): the organization's name, images, currency and time zone.
* [Roles & Permissions](/administration/roles-and-permissions): who can open Profile Customization.
