User Poll - Configuration Reference

All User Poll settings are managed through the built-in configuration panel. Click Open configuration in the web part toolbar to access it. The panel is organized into tabs:

General settings

Poll setup

Answers

Each answer option has the following properties:

Answers can be reordered using the up/down buttons in the configuration panel. Each answer also displays its current vote count.

Scheduling

Results display

Advanced configuration (JSON5)

The Advanced tab provides a JSON5 editor for settings that don't have dedicated form controls. The following sections are available:

Theme

Layout

Pie chart settings

Fine-tune the pie chart appearance:

Translations

Override any UI label in the translations section:

Example advanced configuration

{
  displayCountInResult: true,
  displayPollQuestionNoteInResult: true,
  displayAnswerNoteInResult: true,
  displayTotalVotes: true,
  maxWidth: '600px',

  theme: {
    primaryColor: '#0078d4',
    secondaryColor: '#F50057',
    chartColors: ['#43A19E', '#7B43A1', '#F2317A', '#FF9824', '#58CF6C'],
    fontFamily: '"Segoe UI", Tahoma, Helvetica, Arial, sans-serif',
  },

  pieChart: {
    radius: 40,
    lineWidth: 93,
    segmentsShift: 0.5,
    labelPosition: 65,
    labelStyle: {
      fill: '#fff',
      fontSize: '5px',
      fontWeight: 'bold',
    },
  },

  translations: {
    poll: 'Poll',
    pollResult: 'Poll result',
    noResults: 'No votes have been submitted yet.',
    total: 'Total',
  },
}

Custom CSS

The Custom CSS tab provides a code editor where you can add CSS rules to style the poll. The following CSS class names are available as styling hooks:

Example: Custom styling

/* Center the poll and limit width */
.nv-poll {
  max-width: 500px;
  margin: 0 auto;
}

/* Style the question text */
.nv-poll-question-text {
  font-size: 1.4rem;
  font-weight: bold;
  color: #333;
}

/* Add a border to the results legend */
.nv-poll-result-legend-wrapper {
  border: 1px solid #eee;
  border-radius: 8px;
  padding: 16px;
}

Data management

CSV export

Export poll results from the configuration panel. The CSV file includes the following columns:

Reset votes

To clear all votes and start fresh, use the Reset votes button in the configuration panel. This permanently deletes all vote data for the poll instance.