Rating Element for Sparkforge Forms, Quizzes, and Surveys
The Rating Element adds visual icon-based rating fields (stars, hearts, thumbs-up, flags, lightbulbs) to Sparkforge Forms, Surveys, and Quizzes. Customize scale length, labels, colors, and how data is stored before it lands in your CRM.
The Rating Element is a configurable field for Sparkforge Forms, Surveys, and Quizzes. Respondents tap an icon — stars, hearts, thumbs-up, flags, or lightbulbs — to rate an experience or product. Ratings flow straight into the CRM, automations, and reports.
What You Can Configure
- Icon type: stars, hearts, thumbs-up, flags, lightbulbs
- Scale length: 1 to 10 steps
- Labels: custom low and high labels (e.g., “Poor” to “Excellent”)
- Storage format: absolute value, percentage, or fraction
- Color: selected and unselected icon states
- Field mapping: map ratings to a custom contact field
How to Add the Rating Element
- From the Sub-Account Dashboard, click Sites and pick Forms, Surveys, or Quizzes.
- Open or create the form, survey, or quiz you want to edit.
- Click the Add Form Element (+) button at the top-left and scroll to the Rating Element.
- Drag it into place.
- Click the element to open its settings panel on the right.
- Configure General, Rating, and Advanced settings (see below).
- Click Preview and hover the icons to confirm color and behavior.
Configuration Reference
General Settings
- Label: the prompt shown to users (e.g., “Rate your experience”)
- Short Label: internal field name
- Field Width: percentage of the row (e.g., 100% or 50%)
- Required: toggle to make the field mandatory
Rating Settings
- Icon Type: stars, hearts, thumbs-up, flags, or lightbulbs
- Icon Alignment: left, center, or right
- Count: 1–10 icons in the scale
- Lowest / Highest Labels: e.g., “Poor” / “Excellent”
- Data Storage:
- Absolute Value — stores the raw rating (e.g., 4)
- Percentage — converts to a percentage (e.g., 80%)
- Fraction — stores as a fraction (e.g., 4/5)
- Selected / Unselected Color: icon colors in each state
Advanced Settings
- Custom Field Name: map the rating to a contact custom field for use in workflows and reports.
Frequently Asked Questions
Which icon types are available?
Stars, hearts, thumbs-up, flags, and lightbulbs.
How long can the rating scale be?
You can set the scale to anywhere from 1 to 10 steps.
How is rating data stored?
You choose: absolute value (e.g., 4), percentage (e.g., 80%), or fraction (e.g., 4/5).
Can ratings flow into the CRM?
Yes. Map the Rating Element to a custom contact field in Advanced Settings, and ratings will populate the contact record for use in automations and reports.
Can I make a rating field required?
Yes. Toggle <em>Required</em> on in General Settings.
Was this article helpful?
Thanks for the feedback.