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

# Submission details

> The detail page of a service submission in the RAY admin portal: the submission's status and details, the submitted answers, external and internal comments, invoices, activity history, and the viewers, assignees and managers of the submission.

## Summary

The submission detail page in the RAY admin portal shows everything about one service submission:
who submitted it and for which unit, its state, the answers, the comment threads, linked invoices,
its history, and the people following it up. It is opened by clicking a submission in a service's
**Submissions** tab. See [Service submissions](/services/submissions) for the list.

## Where to find a submission's detail page

* Menu: **Services → `<service name>`**, then click the submission (or **View**) in the
  **Submissions** tab.
* The page title is the submission's title followed by its number, for example "Leaking tap #1042".

## Submission header

The header shows the submission's **Status** with the same menu as in the Submissions list
(**Acknowledge**, **Complete**, **Cancel**, **Reopen** and the form's own statuses), and a **Download**
button that opens a copy of the submission in a new browser tab. See
[Service submissions](/services/submissions) for what each state means.

## Submission detail fields

| Field                                | Arabic label                | Meaning                                                                              |
| ------------------------------------ | --------------------------- | ------------------------------------------------------------------------------------ |
| **Submitted By**                     | مقدَّم مِن                  | The person who submitted it.                                                         |
| **On Behalf Of**                     | بالنيابة عن                 | The tenant the submission was made for, when staff submitted it on someone's behalf. |
| **Unit**                             | الوحدة                      | The unit. Links to the unit for users who can see **Properties → Units**.            |
| **Company**                          | الشركة                      | The company, if any. Links to the company.                                           |
| **Location**                         | الموقع                      | The submitter's address.                                                             |
| **Phone Number**                     | رقم الهاتف                  | The submitter's phone number.                                                        |
| **Category**                         | الفئة                       | The form's category.                                                                 |
| **Form**                             | استمارة                     | The submitted form.                                                                  |
| **Created at**, **Last Modified at** | تاريخ الإنشاء، آخر تعديل في | When the submission was created and last changed.                                    |
| **Rating**                           | التقييم                     | The submitter's rating and feedback, if given.                                       |
| **Cancellation Reason**              | سبب الإلغاء                 | Shown only for **Cancelled** submissions.                                            |

## Submission detail tabs

| Tab                   | Arabic label   | What it contains                                                                  |
| --------------------- | -------------- | --------------------------------------------------------------------------------- |
| **Form**              | استمارة        | The submitted answers, read-only, and the submission's description.               |
| **External Comments** | تعليقات خارجية | One comment thread.                                                               |
| **Internal Comments** | تعليقات داخلية | A separate comment thread.                                                        |
| **Invoices**          | فواتير         | Invoices linked to the submission. Shown only to users with the invoices feature. |
| **Activity**          | النشاط         | The submission's history.                                                         |
| **Viewers**           | المشاهدون      | Users and email addresses following the submission.                               |
| **Assignees**         | المكلّفون      | Users assigned to the submission.                                                 |
| **Managers**          | المدراء        | Users managing the submission.                                                    |

## How to add a comment to a submission

1. Open the submission and select **External Comments** or **Internal Comments**.
2. Click **Add**.
3. Enter the **Comment** (required).
4. Optionally add **Images** (PNG, JPEG, JPG) and **Attachments** (PDF, DOC, DOCX, XLS, XLSX, XLSM,
   XLSB, CSV).
5. Click **Save**.

Comments cannot be added to **Completed** or **Cancelled** submissions; the **Add** button is not
shown. In some services **Add** is disabled and comments cannot be added from the portal. A thread
with no comments shows "No Comments".

## Submission activity

The **Activity** tab lists what happened to the submission and who did it, in order: status changes,
people added as viewers, assignees or managers, company approval steps, and invoice events such as an
invoice being created, issued, approved, rejected, voided or paid.

## How to add viewers, assignees or managers to a submission

1. Open the submission and select **Viewers**, **Assignees** or **Managers**.
2. Click **Add**.
3. Choose the **Users**. For **Viewers** you can also enter **Emails**, comma-separated.
4. Click **Save**.

To remove someone, use **Delete** on their row. People cannot be added to a submission that is
**Completed**, **Cancelled** or **Reopened**; the **Add** button is not shown.

The form's own viewers, assignees and managers, set in the form settings, are added to each new
submission automatically. See [Service categories and forms](/services/categories-and-forms).

## How to create an invoice for a submission

1. Open the submission and select **Invoices**.
2. Click **Add** and fill in the invoice.
3. Save the invoice.

The **Invoices** tab lists each invoice's **ID**, **Billed to**, **Status**, **Total**, **Remaining**,
**Issue Date** and **Due Date**; clicking an invoice opens it. **Add** is not shown for **Completed**
or **Cancelled** submissions, or when the user who would be billed is no longer active.

## Common questions about submission details

### How do I assign a request to a technician?

Open the submission, select **Assignees**, click **Add**, choose the technician and click **Save**.

### How do I add a viewer by email address?

Open the submission's **Viewers** tab, click **Add**, enter the address under **Emails**, and click
**Save**. Several addresses can be entered, separated by commas.

### Why can't I add a comment?

The submission is **Completed** or **Cancelled**, or the service does not allow comments from the
portal. Reopen the submission first if it needs more follow-up.

### Why is the Invoices tab missing?

The **Invoices** tab is shown only to users whose role includes the invoices feature.

### Who submitted this request if staff created it?

**Submitted By** shows the staff member who created it, and **On Behalf Of** shows the tenant it was
created for.

## Related pages

* [Service submissions](/services/submissions): the list, states and bulk actions.
* [Service categories and forms](/services/categories-and-forms): the form settings behind a submission.
* [Services](/services/overview): how services are organized and who can access them.