For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rating

The Avonni Rating component enables users to provide feedback and rate items using interactive star ratings.

The Rating component lets users select a numeric value within a configurable range, displayed as interactive icons (stars by default). It supports required, read-only, and disabled states and exposes the selected value as a flow output variable.


Overview

Use the Rating component in surveys, feedback flows, or anywhere you need a user to score something. The selected value is automatically available after the screen — wire an On Change interaction to respond in real time, or read the output variable in a subsequent flow step.

Example: A customer satisfaction survey flow asks users to rate their support experience. After the screen, use the Value output variable in a Decision element: ratings below 3 trigger an escalation path, while 4–5 trigger a thank-you message.


Configuration

To configure it, click the component on the Flow screen. The Edit Rating Component panel opens on the right with three tabs: Properties, Interactions, and Style. The sections below mirror the Properties tab.

Properties

Setting
What It Does

Label

Text displayed above the rating input to describe what is being rated (e.g., "Rate your experience").

Value

The initial (pre-selected) rating value. Connect to a Salesforce field, a flow variable, or use a Query to aggregate a score (e.g., average rating across multiple records).

Field Level Help

An info icon tooltip displayed next to the label to guide users.

Icon Name

The Lightning Design System icon used for each rating symbol. Default: stars (utility:favorite). Can be changed to hearts, thumbs-up, or any utility icon.

Icon Size

Size of the rating icons: X-Small, Small, Medium, or Large (default).

Selection

Continuous (default) — users can select any decimal value. Single — restricts selection to whole numbers only.

Variant

Controls how the label is displayed: Standard (label above), Label Hidden, Label Inline (label to the left), or Label Stacked (floating label).

Minimum

The lowest selectable rating value. Connect to a field or set a query for a dynamic minimum.

Maximum

The highest selectable rating value (determines the total number of icons shown). Connect to a field or set a query for a dynamic maximum.

Required

When enabled, the user must provide a rating before the flow can advance.

Disabled

When enabled, the rating is visible but cannot be changed by the user.

Read Only

When enabled, displays the current value without allowing interaction.

Advanced Options

Setting
What It Does

Value Hidden

When enabled, hides the numeric value shown next to the icons.


Interactions

Interactions define what happens when users interact with the Rating. Configure them from the Interactions tab of the Edit Rating panel.

Change

Fires when the user selects or changes the rating value. Use this to respond in real time — for example, show a toast message, navigate to a different screen, or trigger a confetti animation based on the selected score.


Styling

The Style tab gives you fine-grained control over the Rating's appearance. Configure it from the Style tab of the Edit Rating panel.

Controls outer spacing.

  • Top: Space above the component.

  • Right: Space to the right of the component.

  • Bottom: Space below the component.

  • Left: Space to the left of the component.

Output Variables

The Rating exposes output variables you can reference in your flow after the screen. To use them, select the screen element in Flow Builder, then the Rating component, and pick the output variable you need.

Selected Value

Output variable
Type
What it returns

Value

Integer

The numeric rating the user selected (e.g., 4 out of 5). This is automatically available after the screen — no interaction setup is needed to capture it.


Using the Rating Results

Once users have given their ratings, you can use that data within your flow:

  • Store It: Save the rating to a Salesforce record to track customer satisfaction, lead scores, etc.

  • Make Decisions: Use the rating to determine the next steps — a high rating leads to a thank-you message, while a low rating triggers a follow-up survey or escalation.

Last updated

Was this helpful?