Advanced types
Sophisticated question types for ratings, feedback, and enhanced form experiences
Advanced question types provide powerful ways to collect nuanced feedback, organize multi-page forms, and create engaging survey experiences. These types go beyond simple text inputs and choices to enable sophisticated data collection.
Note: Likert and Ranking question types are available for surveys only. All other advanced types can be used in both surveys and forms.
Rating
Customizable rating scale for measuring satisfaction, agreement, or preference levels. Displays as interactive buttons or stars.
Use cases
- • Customer satisfaction scores (e.g., 1-5 or 1-10 scale)
- • Product or service ratings
- • Agreement scales (strongly disagree to strongly agree)
- • Likelihood to recommend (Net Promoter Score)
Example configuration
{
"question_text": "How satisfied are you with our service?",
"question_type": "rating",
"is_required": true,
"rating_min": 1,
"rating_max": 5,
"rating_labels": {
"1": "Very dissatisfied",
"5": "Very satisfied"
}
}Configuration options
- rating_min - Minimum rating value (typically 0 or 1)
- rating_max - Maximum rating value (typically 5 or 10)
- rating_labels - Optional labels for specific values (e.g., min and max)
Best practice: Use 1-5 scale for simplicity, or 0-10 for Net Promoter Score questions. Add labels for the minimum and maximum values to provide clear context.
Reaction
Visual emoji-based feedback for quick, engaging responses. Perfect for sentiment collection.
Use cases
- • Quick sentiment feedback (happy, neutral, sad)
- • Post-interaction ratings
- • Content or article reactions
- • Fun, engaging survey questions
Example configuration
{
"question_text": "How do you feel about this new feature?",
"question_type": "reaction",
"is_required": false
}Visual appeal: Reaction questions display emoji/icon options (like 😀 😐 😞) that respondents can click. This creates a more engaging, fun experience compared to traditional rating scales.
When to use reactions vs. ratings
Use reactions for quick, emotional feedback where exact numbers don't matter. Use ratings when you need precise numeric data for analysis.
Likert
Survey only - This question type is only available for surveys, not forms.
Likert scale for measuring attitudes and opinions with labeled response options (e.g., "Strongly Disagree" to "Strongly Agree").
Use cases
- • Agreement scales for statements or opinions
- • Frequency measurements (never to always)
- • Importance ratings (not important to very important)
- • Research and academic surveys
Example configuration
{
"question_text": "The product is easy to use",
"question_type": "likert",
"is_required": true,
"likert_scale_labels": [
"Strongly Disagree",
"Disagree",
"Neutral",
"Agree",
"Strongly Agree"
]
}Configuration options
- likert_scale_labels - Array of labels for each scale point
- Common scales: 3-point, 5-point, or 7-point
- Labels must be in order from lowest to highest agreement
Research standard: 5-point Likert scales are the most common and provide a good balance between granularity and ease of response. Consider including a neutral midpoint for balanced scales.
Ranking
Survey only - This question type is only available for surveys, not forms.
Drag-and-drop interface for ranking options in order of preference or importance.
Use cases
- • Priority ordering (most to least important features)
- • Preference ranking (favorite to least favorite)
- • Competitive analysis (rank competitors)
- • Decision-making surveys
Example configuration
{
"question_text": "Rank these features in order of importance to you (1 = most important)",
"question_type": "ranking",
"is_required": true,
"options": [
"Real-time analytics",
"Mobile app",
"API access",
"Custom branding",
"Team collaboration"
]
}Configuration options
- options - Array of items to be ranked
- Options are displayed in the order provided, then users drag to reorder
- The response returns the options in the user's ranked order
Important: Limit ranking questions to 3-7 items. Too many options becomes cognitively demanding and may lead to incomplete or inaccurate responses.
Page break
Divides your survey or form into multiple pages for better organization and user experience. Not a question type, but a structural element.
Use cases
- • Breaking long surveys into manageable sections
- • Grouping related questions together
- • Creating a multi-step form experience
- • Improving perceived completion progress
Example configuration
{
"question_text": "Section 2: Your Experience",
"question_type": "page_break",
"is_required": false
}Benefits: Page breaks reduce cognitive load, make forms feel shorter, show progress, and allow users to focus on one section at a time. They can significantly improve completion rates for longer surveys.
Best practices for page breaks
- • Use descriptive titles for each page/section
- • Group 3-5 related questions per page
- • Don't break up tightly related questions
- • Show a progress indicator when using multiple pages
Content block
Rich content display for adding formatted text, images, links, and other media. Not a question type - used for providing information or context within your form or survey.
Use cases
- • Instructions or explanatory text
- • Section introductions or descriptions
- • Terms and conditions or privacy notices
- • Images, videos, or embedded content
- • Formatted content with headings, lists, and links
Example configuration
{
"question_text": "Privacy Notice",
"question_type": "content_block",
"question_html": "<p>Your responses are <strong>confidential</strong>...</p>",
"is_required": false
}Configuration options
- question_html - Rich HTML content from Tiptap editor
- Supports formatting: bold, italic, headings, lists, links, images
- Does not collect a response (it's informational only)
Editor integration: Content blocks use the Tiptap rich text editor, allowing you to create professional-looking formatted content directly in the form builder. Add headings, bullet points, bold text, links, and more.
Best practices
Choose rating scales wisely
Use 1-5 for general satisfaction, 0-10 for Net Promoter Score, and consider whether labels on every point or just min/max serve your purpose best.
Use reactions for quick feedback
Emoji reactions work great for post-interaction feedback where you want high engagement and don't need precise numeric data. They're fun and fast.
Limit ranking items
Keep ranking questions to 3-7 items maximum. Ranking too many items is cognitively demanding and leads to poor-quality responses.
Use page breaks strategically
Break long surveys into logical sections with 3-5 questions per page. This improves completion rates and makes forms feel less overwhelming.
Add context with content blocks
Use content blocks to provide necessary context, instructions, or information. Well-placed explanatory content helps respondents provide better answers.
Be consistent with Likert scales
If using multiple Likert questions in one survey, use the same scale labels throughout for consistency and to avoid confusion.
Remember survey-only restrictions
Likert and Ranking questions are only available in surveys, not forms. Plan your question strategy accordingly when building forms.