--- title: "Fields" canonical: "https://support.appfire.com/space/SURVOTE/1846247973/Fields" format: markdown --- > Macro (aura-html) # Fields > ℹ️ **Configurable parameters can be updated in the macro editor**: Edit the page, click the macro you want to update, and click **Edit** button to launch the Macro editor. > ℹ️ > ℹ️ Survey/Vote columns: > ℹ️ > ℹ️ :check_mark: If checked, indicates availability in either/both Survey or Vote macros > ℹ️ > ℹ️ :cross_mark: If crossed out, indicates field is not available for either Survey or Vote macro, depending on the column > ℹ️ > ℹ️ :yellow_star: Required - Indicates this is a required field for that macro | **Field** | **Default** | **Survey** | **Vote** | **Description** | | --- | --- | --- | --- | --- | | **Survey/Ballot Title** | none | :check_mark: | :check_mark:
:yellow_star: Required | Currently, in the Survey macro, the title is optional but the Actions dropdown will not be available if the title is not configured.
:warning: **Titles must be unique across multiple uses of the macros on the same page**. Failure to maintain unique titles may result in unexpected behavior.
In the future, surveys without titles may not be supported. | | **HTML header level for title** | 2 | :check_mark: | :check_mark: | The HTML header level of the title. 1 for h2, 2 for h2, etc.
0 renders as regular text, and will not show up in the TOC macro that uses HTML headers for TOC items. | | **Override default choices** | 5-Outstanding, 4-More Than Satisfactory, 3-Satisfactory, 2-Less Than Satisfactory, 1-Unsatisfactory | :check_mark: | :cross_mark: | Surveys only.
This is a comma-separated list of choices that will override the defaults. Each choice must indicate a number value and name, separated by a hyphen. Example: 5-Best
The numerical part should be in ascending OR descending order.
**You must also set the "Value of the last choice" and "Iteration step" fields to match.**
For example: to use the order 1, 2, 3, 4, 5 instead of 5, 4, 3, 2, 1
- Use Iteration step: -1 - and "Value of the last choice": 5.
The default order of 5, 4, 3, 2, 1 uses an Iteration step of 1 and a "Value of the last choice" of 1. | | **Changeable votes** | false | :check_mark: | :check_mark: | If true this will allow the users to change their responses until the survey is locked.
Recommended, as this will improve voter experience: (No one likes accidentally clicking the wrong choice and not being able to change it.) | | **Summary location** | Top | :check_mark: | :cross_mark: | Surveys only.
Where the location of the results summary table will appear.
Top: Above the choices
Bottom: Below the choices
None: No results displayed! | | **Allow/Show comments** | Survey: true
Vote: false | :check_mark: | :check_mark: | Allow users to comment on choices | | **Value of the last choice** | 1 | :check_mark: | :cross_mark: | Surveys only
If you have updated Override defaults choices, make certain this field matches that configuration.
Example: for the default series of choices with numerical values: 5,4,3,2,1,  the Value of the Last Choice should be set to: 1 | | **Iteration step** | 1 | :check_mark: | :cross_mark: | Surveys only
If you have updated Override defaults choices, make certain this field matches that configuration.
Examples:
1. Default order 5, 4, 3, 2, 1 uses an Iteration step of 1 2. For the alternative order 1, 2, 3, 4, 5 Set the Iteration step to -1
The purpose of iteration step is to support calculation for the summary average numbers.  As the first options in surveys usually are the highest priority the calculation is reversed. | | **List of manager groups** | all groups | :check_mark: | :cross_mark: | Surveys only A comma-separated list of GROUPS who are allowed to manage survey operations (exporting, locking, resetting). See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. | | **List of managers** | all users | :check_mark: | :cross_mark: | Surveys only A comma-separated list of USERS who are allowed to manage survey operations (exporting, locking, resetting). See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. | | **List of voter groups** | all groups | :check_mark: | :check_mark: | This is a comma-separated list of GROUPS who are allowed to cast a vote. See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. | | **List of voters** | all users | :check_mark: | :check_mark: | This is a comma-separated list of USERS who are allowed to cast a vote. See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. | | **List of result viewer groups** | all groups | :check_mark: | :check_mark: | This is a comma-separated list of GROUPS who are allowed to see the summary table results. See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. | | **List of result viewers** | all users | :check_mark: | :check_mark: | This is a comma-separated list of USERS who are allowed to see the summary table results. See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. | | **Always show results** | false | :check_mark: | :check_mark: | Show results immediately, ignoring the list of result viewers and the need to have voted first. | | **Show list of users who voted** | false | :check_mark: | :check_mark: | Shows the list of users who have voted. | | **Pending voters** | false | :check_mark: | :check_mark: | Show the list of users who still need to vote.
:warning: Requirement: **either** one of these must be set in order for Pending voters to be displayed:
- List of Voters - List of Voter Groups | | **Username style** | plain login name | :check_mark: | :check_mark: | When users are listed (pending voters list, show list of users who voted, commenting interface, etc), they can be rendered in one of 4 ways:
1. plain login name - This is just the username of the user. Example: asmith 2. linked login name - This is the username, but linked to their profile. 3. plain user name - This is the full name of the user. Example: Alice Smith 4. linked user name - This is the full name of the user, but also linked to their profile. **Recommended** | | **Email delimiter** | , | :check_mark: | :check_mark: | Some features offer email buttons. Example: pending voters will provide an email button to facilitate reminding users that haven't voted yet.
Some email clients will handle different delimiters more gracefully than others. The default is comma: `,`
Outlook may behave better with semi-colon, so if you're organization requires the use of Outlook for internal emails, configure this field to semi-colon: `;` | | **Condensed view** | false | :check_mark: | :cross_mark: | Surveys only
Each question is one row of a table. Many other features are disabled including comments, list of voted users and statistics | | **Locked** | false | :check_mark: | :check_mark: | Locks the macro, and no further votes may be submitted.
For survey macros, Clear all Votes is not available when the survey is locked.
Locking can be undone at any time. Either uncheck the Locked parameter in the macro editor. Or, for surveys with titles, survey managers will be allowed to Lock or Unlock the survey from the Actions dropdown. See [Permissions](https://appfire.atlassian.net/wiki/spaces/SURVOTE/pages/382140420/Get+started#Survey%26VoteServer-UserGuide-Permissions) for more details. |