Focus Words
The Focus Words components allow you to place Focus Words visualizations onto a dashboard page. The following Focus Words components are available in the FOCUS WORDS group of the components menu:
- Results Drivers — displays results driver analysis.
- FW Topic Frequency Bar Chart — displays topic frequency as a bar chart.
- FW Topic Code Frame Stacked Bar Chart — displays topic ratings with code frame stacking.
- FW Topic Average Rating Bar Chart — displays average topic ratings as a bar chart.
- FW Topic Frequency Spline Chart — displays topic frequency over time as a spline chart. It shows 5 periods by default.
- FW Topic Rating Average Spline Chart — displays rating trends over time as a spline chart. It shows 5 periods by default.
- FW Topics Overview Table — displays a topic summary table.
- FW Sub Topics Overview Table — displays a sub-topic summary table.
Focus Words visualizations will take up the entire page. It is recommended that the full width of the dashboard page is used for Focus Words components.
Properties
Section titled “Properties”- Component Name — enter a label for the component (optional). The label will not be visible in the dashboard; it is useful for identifying components quickly while laying out your dashboard.
- Focus Words Settings — connect the component to a Focus Words project (see below).
Focus Words settings
Section titled “Focus Words settings”The Focus Words component requires connection to an existing Focus Words project within the same sub account. Only published Focus Words projects are listed. To configure:
- Under Focus Words Settings, select the Project you would like to visualize.
- Choose the Version. Depending on the component, the options are Version 1 / Version 2 or Results V1 / Results V2.
- Enter a Title for the component.
- If the Focus Words project is based on an EVE survey, turn on Is Eve Conversation so that conversation transcripts are formatted correctly in your dashboard.
- Choose the Rating Type: Satisfaction (CSAT) or Net Promoter Score (NPS).
- Turn on Include Uncategorised Comments if you want comments that don’t belong to a topic to be included.
- Click Filters Mapping to connect the dashboard filters to the filters in the Focus Words project.
Map dashboard filters
Section titled “Map dashboard filters”The Filters Mapping button only appears once a project is selected and the dashboard has at least one filter. Clicking it opens the Pair Filters dialog, where you pair each dashboard filter with a filter in the Focus Words project.
- The dashboard’s Timeframe and Period filters are paired automatically, and these rows can’t be changed.
- Drag rows to reorder them.
- Delete a pair you no longer need.
Multi-select dashboard filters are supported for all Focus Words components except the version 1 Results component (Results V1).
When a viewer drills into a topic in the published dashboard, the dashboard filter bar is hidden.
Frequently asked questions
Section titled “Frequently asked questions”Do Focus Words components connect to a data store or data exploration?
No. Focus Words components connect directly to an existing Focus Words project within the same sub account — they do not use the standard data store or data exploration connection. You select the project from the Focus Words Settings panel.
Why can’t I see my Focus Words project in the list?
Only published Focus Words projects in the same sub account are listed. Publish the project in Focus Words, then select it again in Dashboard Publisher.
What’s the difference between version 1 and version 2?
When configuring a Focus Words component, you can choose between version 1 and version 2 of the visualization in the Version setting (Version 1 / Version 2, or Results V1 / Results V2, depending on the component). Version 2 is the newer implementation with updated visuals.
Can I use dashboard filters with Focus Words components?
Yes. Map dashboard filters to Focus Words filters using the Filters Mapping button in the component settings, which opens the Pair Filters dialog. Multi-select filters are supported, except by the version 1 Results component (Results V1).
Why don’t I see the Filters Mapping button?
The Filters Mapping button only appears when two conditions are met: your dashboard has at least one filter defined, and the Focus Words component has a project selected. Add your filters first and select a Focus Words project, then the button will become available.
What happens if filters are removed from the Focus Words project?
If filters are removed from the Focus Words project after you’ve set up the dashboard mapping, Dashboard Publisher will automatically clean up the invalid mappings and show a notification listing which filters were removed. You may need to review and update the filter mapping.
Why does my Focus Words component show an error icon?
If the project’s rating variable, or a field used by a mapped filter, has since been excluded from exports and AI, the component shows an error icon instead of data. Excluded fields are withheld from Dashboard Publisher. If a mapped filter is affected, remove that pair in Pair Filters. Otherwise, ask the data owner whether the field can be included again.
Do Focus Words components work well alongside other components on the same page?
Focus Words visualizations are designed to take up the full width of the page. It’s recommended to dedicate an entire page to Focus Words components rather than placing them alongside other chart types.
What does “Access Required” mean for a Focus Words project?
The message “You have no access to this Focus Words Project” means your account doesn’t have permission to view the selected project.
- Check with your admin — ask them to grant you access to the Focus Words project you need.
- Choose a different project — select a Focus Words project within a sub account you have access to.