Survey Access Settings

Learn how to use Access Settings to configure the Assignments and Access Roles when viewing survey analytics.

In this article:



Access Settings gives you the option to configure custom roles and assignments to provide survey access in ways that fit your organization's needs.

Assignments can be thought of as the who, it specifies who has access to specific areas of your survey's analytics, i.e. the entire survey, their downline only, a specific branch of your org tree, etc.

Roles can be thought of as the what, it determines what assigned users can see and do via filters, slices, reports, and other capabilities provided to them.

Non-admin users can only access a survey's analytics if they're given an Assignment and Role for the specified survey. 

Learn about testing user access to survey analytics.

Access Access Settings

To access a survey's Access Settings: 

  1. Click and expand Analytics in the left-hand navigation menu
  2. Click Surveys & Pulses from the expanded menu 
  3. Click and navigate to a survey's analytics
  4. Click Access Settings in the top-right 


As an admin, Assignments give you the flexibility to give analytics access to specific areas of your organization.

For example, an Assignment can give a user visibility into the entire survey, for their own downline only or a branch on an org tree. 

The following assignments are available by default:

  • All Respondents: Provides access to all respondents and org trees for the survey
    • Note: All Respondents replace the legacy Analyst assignment
  • Manager Org Tree:  Automatically gives managers access to their own downline
    • As an automatically generated role, the role name can not be edited
    • Note: Ongoing or automated surveys triggered by Hire & Exit Dates, and New Manager events do not automatically generate a manager org tree
  • Custom Org Tree: Assign any user, with any Role, to any branch of the tree
    • Create an Org Tree to your specifications, learn how
  • Survey Author: Automatically created and assigned to the Focused Admin who created a survey
    • As an automatically generated role, the role name can not be edited 

How to Assign Users to a Custom Org Tree

To assign a user to a Custom Org Tree, click the desired Custom Org Tree, in this case, the Location-Department tree.


When viewing the various branches, click the Edit icon at the end of the corresponding row to assign a user to that branch along with its downline, if any. 

In the GIF below, an employee named Zane is being added to the HRBP role for the Boston office's Finance branch for the Location-Department tree. 


How to Create a Custom Org Tree

The Org Tree Creator is organized into three columns: 

  • Attributes: Your organization's demographic attributes 
  • Org Tree Structure: A customizable and interactable field where the Org Tree structure is determined via the hierarchy of attributes
  • Preview: As you click and drag attributes into the Org Tree Structure column, a real-time preview reflects what your org tree will look like

To create a Custom Org Tree: 

HubSpot Video
  1. Click Create Org Tree to navigate to the Org Tree Creator
  2. In the Org Tree Name field, enter an easily identifiable name e.g. Location-Department 
  3. Click-and-drag attributes from the Attributes column to the Org Tree Structure column in the specific hierarchical order
    1. Org trees allow a maximum of five attributes and can be rearranged as necessary
  4. In the Preview column, view and interact with the real-time org tree preview
  5. Click Publish to finalize your org tree or Save Draft to resume at a later date

Access Roles

As an admin, you have complete flexibility in customizing what users have access to.

For example, a Manager role can give users some access to filtering and slicing survey data but does not give the role access to comments, replies, or the heat map. 


To streamline this process, every people leader in your organization is automatically given the Manager role. Some of these other automatically created roles include: 

  • Manager Role
    • When a survey is launched, the Manager role is automatically created and all managers in your organization are automatically added to this role
    • The Manager role's filter and slice settings are determined by your General Settings, these settings can be personalized per survey
    • As an automatically generated role, the role name can not be edited
  • Survey Author Role
    • When a survey is launched by a Focused Admin, the Survey Author role is automatically created
    • The View Themes and Manage Themes settings are automatically enabled on the Comments report for this role, other settings can be personalized per survey
    • As an automatically generated role, the role name can not be edited
  • Additional Roles
    • An administrator can manage the existing settings for Focused Admins and create additional roles to grant access to other leaders and managers in your organization- learn more about Focused Admins

How to Create a New Role

New Roles can be created as needed to provide survey access to HRBPs, senior leadership, etc., or to plan a phased rollout of access to the survey's results. 

To create a new Role: 

  1. Click and navigate to the Access Roles tab
  2. Click Add Role to view a blank Role 
  3. Enter a name for the Role
  4. Configure Role Access with Live Response Rate Access and/or Reporting Access
  5. Configure User View options
  6. Manager the users in the role
  7. Click Save

Alternatively, to use an existing role as a starting template- click the role's copy icon. Learn more.

Use the Enable Access toggle to activate a role on the specified access date.

Live Response Rate Access

Enable access to Live Response Rate to configure a role's ability to view and monitor survey completion rates and prepare for the survey closing and subsequent analytics. 

Learn more about the Live Response Rate.

To enable Live Response Rate access:

  1. Enable the Assign Access option (Figure A) to give users in this role access to the survey's Live Response Rate 
  2. Schedule the date and optionally, the time of day, when user access to the Live Response Rate is active (Figure B)
    • Optionally, enable Send Access Notification (Figure C) if users should receive notifications when they receive access 

Continue to configure the role's settings. Click Save to save the role's settings.

Reporting Access

Enable access to reporting to give users customized visibility into survey results. 

Learn more about survey analytics.

To enable Reporting access:

  1. Enable the Assign Access option (Figure A) to give users in this role access to the survey's analytics
  2. Schedule the date and optionally, the time of day, when user access to survey analytics is active (Figure B)
  3. Specify the options enabled for this role's access in the survey's analytics:
    • C. View Comments: Specify if users can view the Comments report and which of the sub-features the role has access to, learn more
    • D. View Comment Summaries: Specify if users can view and/or use the Smart Summary feature, learn more
    • E. Heat Map: Specify if users can view the Heat Map report, learn more
      • This requires the ability to slice by demographic
    • F. Engagement Level Report: View engagement trends at the organizational level, learn more
    • G. View Invited Participants: Specify if users can view a list of survey participants
      • View Invited Participant Demographics: Specify if users can view the demographic attributes for each respondent, only attributes that can be sliced or filtered by the role are visible
    • H. Action Planning: Specify if you can take advantage of Action Planning from the beginning of the survey to effectively increase employee engagement, learn more
    • I. Benchmarks: Specify if benchmarks are available to compare with your analytics
    • J. Demographic Filters & Slices: Determines which demographic attributes this role can use to filter and slice results

Continue to configure the role's settings. Click Save to save the role's settings.

User View Options

Configure who the user has visibility into relative to their node in the org tree.

To configure the user view options: 

  1. Click the current user view selection to open a selection modal 
  2. Select a user view option: 
    • Downline Only: Gives users visibility into their downline's results
    • Downline & Limited Overall: Gives users visibility into the results of their downline and the organization overall, but slices & filters can not be applied to the organization's overall results
    • Downline, Limited Upline, and Overall: Gives users visibility into the results of their downline. It also gives visibility to upline teams and the organization overall, but slices & filters can not be applied to the org's overall results

      Managers who don't meet the confidentiality minimum threshold are prompted to navigate to an upline manager who has met the minimum threshold: 
  3. Click Save

Continue to configure the role's settings. Click Save to save the role's settings.

Users in the Role

Manage the user(s) assigned to this role. 

To manage the users in the role:

  1. Click Select Users
  2. In the Add Users field, enter the user(s) to add them to the role
    • A user must be assigned to an org tree to view survey results- the Tree Access Assigned field notifies you of their status
  3. Optionally, if the role is active, click Send Notification to notify the user(s) of their role
  4. Click Save

Alternatively, click Add by Username to either upload a CSV file or manually enter the usernames of the users. Click Import to finalize the users.

Continue to configure the role's settings. Click Save to save the role's settings.

Test Access

As an admin, test and preview a user's visibility into a survey's analytics to ensure users have the correct level of visibility into survey analytics.


To preview survey access, both of the following conditions must be satisfied:

  • Click Assign Access for Live Response Rate Access or Reporting Access
  • A user must be assigned to a branch of the manager org tree/custom org tree or assigned to All Respondents

A user without an Assignment is listed with, No Access Assigned, in their Access Assigned column.

The Enable Access toggle does not affect the ability to preview as long as both conditions, mentioned above, are met. 

Preview Survey Access

The Test Access tab displays all users with a role or assignment. 

Each row represents the user, their Role and their status, as well as whether the user is assigned to All Respondents or an Assignment of a manager/custom org tree. 

To preview a user's access to a survey's analytics:

  1. Click and expand Analytics in the left-hand navigation menu
  2. Click Surveys & Pulses
  3. Click on the survey 
  4. Click Access Settings in the top-right
  5. Click and navigate to the Test Access tab
    • Every user with any level of access, i.e. an Assignment or Role, is listed in this tab
  6. Click Preview Access to preview the survey analytics
  7. In the modal, confirm the details and click Proceed to Preview 
  8. To end the preview and return to the Test Access tab, click Close Preview in the preview banner

Preview Limitations

As you preview survey analytics as a user, there are a number of limitations in place to be aware of: 

  • While previewing as a user, any actions taken by the previewer are attributed to the previewed user
  • While previewing as a user, you can export, filter/slice the results based on the permissions of the user being previewed
  • Features available only to admins, i.e. Access Settings, etc. are not visible while previewing a non-admin user