In this article
The Response Rate widget displays response data and allows navigating to a specific page. It has customization options using CDL.
The Response Rate widget calculates the response rate based on a specific expression using the default survey as input. Adding the widget to the canvas displays a pre-configured output including the main response breakdown chart and two tiles showing the number of invitations and response rate. The property sheet provides limited options for additional configuration.
The Category widget displays the responses to a question by category in a bar chart or pie chart format. The values can be represented as either the count of responses or the percentage of responses for each category.
You can rearrange or remove the tiles displaying the number of invitations and response rate.
Note
If you remove a tile, it cannot be added back to restore the original configuration of the widget. To return to the standard configuration, you need to create a new widget.
The widget allows you to navigate to a specific page by clicking on a response category in the chart, which filters the page based on the selected category. This feature is useful for displaying additional details about survey respondents, such as those who haven't responded to the invitation yet.
You can choose to include incompletes in the response rate calculation by turning on the "Include incompletes" toggle.
The formula used by the Response Rate widget calculates the response rate based on specific definitions:
| Measure | Definition |
|---|---|
Full Response | System variable status has value of “complete” |
Partial Response | System variable status values are not “complete” or “error” |
No Response | All other values of system status, including blank |
Invitations | System variable smtpstatus in the respondent table has value of “MessageSent” |
Response Rate | ((Full or Partial responses) / Invitations) *100 |
Note
The Response Rate widget accurately reports data from both the responses and the respondent's tables by using the Created Date from the responses table. This date, which represents when the respondent was uploaded into the system, will override the date field set in the filter when date-filtering is applied to the widget.
Example Setup of a Response Rate Widget
Setting up a response rate widget
Resulting response rate widget with the above widget
Advanced Configuration
The Response Rate widget can be customized with CDL by using any survey question or derived variable to display the responses, or by using a custom formula for the response rate calculation. However, if a non-standard formula is used, the properties in the property panel will not be editable.
For details of the properties and settings, refer to widget responseRate in the CDL Reference Guide.