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

# Create and manage review forms

> Learn how to create review forms, configure fields, and review submissions in Masivo

## Review forms in Masivo

Navigate to **Review forms** in the left sidebar. The section has two tabs:

* **Review forms** — list and manage review form definitions
* **Reviews** — all reviews across forms

## Creating a new review form

On the **Review forms** tab, click **New form** (requires **review\_forms** write permission). You land on the editor with two main sections: **Base Settings** and **Fields**.

### Base settings

Configure:

* **Name** — unique per account (used internally and in lists)
* **Description** — optional internal notes
* **Type** — `Rating`, `Comment`, `Thread`, or `Custom`
* **Status** — `Active` or `Inactive` (only active forms are available via the Storefront API)
* **Journey** — optional automation journey linked to reviews submitted through this form

### Fields

Use **Add field** to define each question or input that channels must send when creating a review.

For each field set:

* **Field name** — API key used in `answers` (for example `score`)
* **Label** — display label for your UI
* **Type** — Score, Text, Select, or Multi select
* **Required** — whether the answer is mandatory

Additional settings by type:

* **Score** — min and max values (default 1–5)
* **Select / Multi select** — use **Add option** for each choice (label and value)
* **Images** — optional, up to five per field; use **Add image**, then **Select an image** to pick or upload from your multimedia library, and set **Alt** text

<Tip>
  Field names must be unique within the form and should stay stable after launch.
  Clients submit answers keyed by field name, not by label.
</Tip>

When you are done, click **Save** in the form actions panel to create the review form.

## Editing and deleting

Return to **Review forms** in the sidebar. In the table, each row shows the form name and actions:

* **View** — open reviews for that form only
* **Edit** — update settings and fields (requires **review\_forms** write)
* **Delete** — soft-delete the form (requires **review\_forms** delete)

The edit URL follows `/crm/review-forms/{reviewFormId}/update`.

## Reviewing submissions

### All reviews

Open **Reviews** in the secondary navigation (path `/crm/review-forms/reviews`) to see every review for the account. Use table filters and search to narrow results.

### Per review form

From the **Review forms** tab, click **View** on a row, or go to `/crm/review-forms/{reviewFormId}`. You see only reviews for that form.

The reviews table includes:

* **Received** — submission timestamp
* **Customer** — `customer_id` or `-` for anonymous
* **Source**, **Platform**, **Brand**, **Channel** — attribution dimensions
* **Answers** — JSON payload keyed by field names

## Next steps

To load review form definitions and submit reviews from your app, follow [Submit reviews](/api-reference/guides/submit-reviews) in the API reference.

For domain concepts (field types, events, permissions), see [Review forms](/concepts/review-forms).