> ## 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.

# Highlights

> The Highlights screen of the RAY admin portal manages the highlight banners shown to users: Feature Highlights open an app feature, Description Highlights show a description, External Link Highlights open a link; each has an image, audience and a Visible After date, can be reordered, archived and deleted. Found under Community → Highlights.

## Summary

The **Highlights** screen in the RAY admin portal manages highlights: image banners shown to users. A
highlight is one of three types, and it becomes visible from its **Visible After** date. The screen has
two tabs: **Active** (مفعّل) and **Archived** (الأرشيف).

| Type                        | Arabic label                       | What the portal says it does                                                                                 |
| --------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Feature Highlight**       | المحتوى المميز على ميزة في التطبيق | "Highlight a feature on the app for your users. Tapping the highlight would redirect to the feature."        |
| **Description Highlight**   | المحتوى المميز على وصف             | "Keep your users informed about the latest updates. Tapping the highlight would show the description."       |
| **External Link Highlight** | المحتوى المميز على رابط خارجي      | "Share an external link with your users. Tapping the highlight opens the link in a browser outside the app." |

## Where to find Highlights

* Menu: **Community → Highlights** (Arabic: **المجتمع ← العناصر المميزة**)
* Tabs: **Active** and **Archived**

## Who can access Highlights

Highlights is shown only to users with an **Admin** role that includes the highlights feature.

## Highlights list columns

**Image**, **Title**, **Type**, **Content** (click **View**), **Users** (the audience: **All Users** or a
number of users), **Visible After**, and actions. In the **Active** tab, drag rows to change the order
of the highlights. The **Archived** tab also shows **Archived On**.

## Highlight fields

| Field               | Required                   | Meaning and rules                                                                                                     |
| ------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Highlight Title** | Yes                        | Per language; required in English.                                                                                    |
| **Image**           | Yes                        | JPG, PNG or JPEG. "The recommended aspect ratio is 2:1 (750x375px). We recommend uploading a self-explanatory image." |
| **Feature**         | Feature Highlights         | The app feature the highlight opens.                                                                                  |
| **Link**            | External Link Highlights   | A valid URL.                                                                                                          |
| **Description**     | Description Highlights     | Rich text with links.                                                                                                 |
| **Attachments**     | No, Description Highlights | PDF, DOC, DOCX, XLS, XLSX, XLSM, XLSB or CSV. "Upload a PDF, DOC, Excel, or CSV file (Max size: 16 MB)."              |
| **Audience**        | Yes                        | **All Users**, or **Specific Users and Groups**.                                                                      |
| **Visible After**   | Yes                        | When the highlight starts to show. Defaults to now.                                                                   |

## How to add a highlight

1. Open **Community → Highlights** and click **Add**.
2. Choose **Feature Highlight**, **Description Highlight** or **External Link Highlight**.
3. Enter the **Highlight Title**, upload the **Image**, and fill in the **Feature**, **Link** or
   **Description**.
4. Choose the **Audience** and the **Visible After** date.
5. Click **Save**.

## How to remove a highlight

* In the **Active** tab, each highlight has **Archive**, **Edit** and **Delete**. **Archive** moves the
  highlight to **Archived**; the confirmation warns "This action is irreversible".
* In the **Archived** tab, the only action is **Delete**. Archived highlights cannot be edited.

## Common questions about highlights

### How do I change the order of the banners?

Drag the highlights into the new order in the **Active** tab.

### How do I schedule a banner for next week?

Set **Visible After** to the date and time it should start showing.

### Can I bring back an archived highlight?

No. Archiving is irreversible. Create the highlight again.

## Related pages

* [News](/community/news), [Events](/community/events), [Deals](/community/deals): content a highlight can promote.
* [Community](/community/overview): the other Community screens.