---
title: "Configuring Developer sentiment surveys"
canonical: "https://support.appfire.com/space/FD/1802305708/Configuring%20Developer%20sentiment%20surveys"
format: markdown
---
> Macro (aura-html)

Configuring a Developer sentiment survey lets you determine the audience and schedule of your quarterly survey. This survey is based on the Developer thriving research done by the Developer Success Lab. It is designed to help you understand and improve the health, culture, and outcomes of your organization.

You can only schedule a single survey per organization per quarter, so make sure to coordinate your survey configuration to include all teams who would like to participate.

All users receive the same survey, and survey results can be separated by team. Learn more about [Developer sentiment surveys](https://appfire.atlassian.net/wiki/spaces/FD/pages/1801945306) to understand how to view results.

## Permissions

- **Manage Survey Configuration**: You need this permission to configure the Developer sentiment survey.
- **Manage Slack Integration**: You need this permission to configure the Slack integration so you can enable Slack notifications for your survey, if your organization does not already have a Slack integration enabled.

## Before you begin

Before you configure and schedule your survey, there are some initial steps you should take:

- Get familiar with the survey.
- Talk with your team about the goals and scope of this survey.
- Decide who you want to take the survey and the best time to schedule it.
- Review your team memberships in Flow. Where possible, only have users be members of one team so survey results are most accurate.
- Make sure all users who you want to take the survey can log in to Flow.

> ✅ You can only schedule one survey per calendar quarter. If a survey has already started in a quarter, you cannot schedule another one to start until the next quarter. If a survey is already scheduled for a quarter that has not started, and you need to create a new one, either edit or remove the previously scheduled survey before proceeding. Make sure your teams are on the same page when an organization-wide survey should be scheduled.

## Reading the survey table

Use the survey table to understand what surveys have been scheduled. This table includes data about all previous and completed surveys, as well as any that are in progress or have been scheduled to start.

![Developer sentiment survey table,](media://e963848a-9086-4ed8-a17f-da4d524d1c37)

- The *Survey name*** **is in the format `[Month-Month:Year:DevThriving]` where the months are the months of the calendar quarter the survey is scheduled to start in, and the year is the year the survey starts.
- The *Status* indicates the current status of the survey. Possible statuses include: Scheduled, In progress, Done.
- *Responses* is the proportion of the total number of users eligible to take the survey who have completed it. For scheduled surveys, this number will always be zero.
- *Team* is the list of individual teams selected for the survey. If the survey is sent to the whole organization, this will say All Teams.
- *Creator* is the Flow user who configured and scheduled the survey.
- *Survey start* is the configured start date and time of the survey, in the specified time zone.
- *Survey end* is the end date and time of the survey in the specified time zone. This is set automatically once the Survey start is configured. It will normally be exactly 14 days after Survey start.
- *Slack* indicates whether the survey is configured to send notifications via Slack.
- *Link*** **is a copiable link to the survey. This link will not work until the survey starts.
- Use the **three dots menu** to delete the survey if it has not already started. You will be prompted to confirm the deletion.

## Adding a new survey

To configure a new survey, click **Add new survey**.

1. Review the resources provided about the survey, anonymity, results, and delivery. Understanding these will help you best configure and share the survey to meet your needs.
2. Determine your *Teams* selection. By default, the survey is sent to all users in the organization, with the ability to view results by team. We strongly recommend sending the survey to the whole organization since only a single survey can be configured per quarter. However, if you'd prefer to send the survey to only a small subset of teams:
  1. Toggle on **Enable individual team selection**.
  2. Use the search box to select teams.
  3. Once teams are selected, toggle off **Include nested teams** if desired.
3. Click **Next **once all team selections are finished.
4. Determine the survey open date. Your survey must start during a quarter that does not contain an already-scheduled survey. If you try to schedule a survey during an unavailable quarter, you will receive an error message and be unable to proceed until you update the date. Click **Next**. The survey will be open for 10 full weekdays (Monday–Friday) and cannot end on a weekend day. Usually, this means the survey will end 14 days after the start date, but if the start date is on a Saturday or Sunday, it will end the second Friday after it starts, meaning it will be open for 12 or 13 days.
5. If you have a Slack integration configured, decide whether to enable Slack notifications for the survey. If you enable automated survey delivery via Slack, choose which Slack channels you want the survey delivered to when it starts. When these notifications are enabled, a single Slack message containing a link to the survey and details about when the survey is open will be sent to the selected Slack channels when the survey starts. You do not need to enable this to proceed with the survey. Click **Next**.
6. Confirm your configurations and make any changes as needed. When all configurations are set, click **Confirm survey selections **to schedule the survey.
7. Copy the link to the survey if you want to send it manually. You can also copy this link later from the survey table.

## Editing a scheduled survey

You cannot edit a scheduled survey, other than to delete it. If you've scheduled a survey and you want to change any of the configurations, you must delete the survey and recreate it.

To delete the survey, click the **three dots menu** and click **Delete**. When prompted for confirmation, click **Delete survey**.

> ℹ️ To simplify the process of recreating a survey, take note of the data in the survey table for the survey you plan to recreate. This table should contain almost all the data you need to recreate the survey quickly.

### Adding users to a scheduled survey

The list of users who can take the survey is determined at the time the survey is scheduled. If anything changes about your users, including their ability to log in, their team membership, or their existence in Flow, you must recreate the survey for those changes to take effect.

## Preparing your team for the survey

After you schedule the survey, take some time to prepare your team. Let them know what it will be like to [take the survey](https://appfire.atlassian.net/wiki/spaces/FD/pages/1802010725), as well as what [results are available from it](https://appfire.atlassian.net/wiki/spaces/FD/pages/1801945306).

To help you share with your team, try sending this message, adjusted so it fits the needs of your organization:

> ℹ️ We're committed to improving the health of our engineering teams and how we operate. As part of this, we are using a survey to help us understand and improve the health, culture, and outcomes of our org.
> ℹ️ 
> ℹ️ The survey will help each team, and our engineering org as a whole, measure four important factors that contribute to thriving developer teams, and show us where we are doing well and where we can improve. To create transparency and help us spark productive discussions, every team member will be able to review the survey results for their team.
> ℹ️ 
> ℹ️ Some quick facts about the survey:
> ℹ️ 
> ℹ️ - Anonymous; we won't be able to see individual responses
> ℹ️ - 10 questions
> ℹ️ - 5-10 minutes to complete