Multi-rating

The rating component asks one rating question. Multi-rating asks several at once — each question gets its own row, the user picks an answer per row, and all selections submit together.

It's the right tool when you want a short structured survey ("rate speed, rate helpfulness, would you recommend us") in one screen instead of three round-trips.

Basic example

Each rating row is one group. The rating per group can be faces, stars, thumbs, or custom — mix and match freely.

- type: meya.tile.component.multi_rating
  label: How did we do?
  groups:
    - title: Speed of response
      rating: stars
    - title: Helpfulness
      rating: faces
    - title: Would you recommend us?
      rating: thumbs

The component returns a list of scores in group order, e.g. [4, 5, 1]. Read it from flow.result.

Requiring all answers

Set required: true to refuse partial submissions. error_message is shown if the user tries to submit without picking every row:

- type: meya.tile.component.multi_rating
  label: Required ratings
  required: true
  error_message: Please rate all three.
  groups:
    - title: Quality
      rating: stars
    - title: Value
      rating: stars
    - title: Service
      rating: thumbs

Custom options

Use rating: custom for non-standard icon sets — useful for product categorization, shape pickers, or branded scales:

- type: meya.tile.component.multi_rating
  label: Custom options
  groups:
    - title: Shape
      rating: custom
      options:
        - icon: streamline-regular/12-design/06-shapes/shape-triangle.svg
          score: 1
        - icon: streamline-regular/12-design/06-shapes/shape-cube.svg
          score: 2

score is what lands in flow.result when the user picks that option.

Where to go next

• rating — the single-question version
• widgets-and-pages — embed multi-rating inside a page form to mix it with text fields
• tile.component.multi_rating reference — full field list and defaults