> For the complete documentation index, see [llms.txt](https://docs.ushahidi.com/platform-user-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ushahidi.com/platform-user-manual/3.-configuring-your-deployment/3.3-surveys.md).

# 3.3 Surveys

***

## What is Survey?

A survey defines critical aspects of a post’s structure and permissions. For example, a post’s “survey” defines which fields are available for contributors to complete, and who can see it when it’s published.

This section will show you how to create and manage surveys on your deployment.

The setup in this guide is demonstrated in the below video as well. You can watch and follow the guide at the same time!

***

## Pre-Requisites

Before configuring the survey on your platform, you'll need to install Ushahidi's platform and set up your deployment. You can complete this task by referring to the following resources: 

* [Installing Ushahidi](https://app.gitbook.com/o/-LEUwSacjzjxNiZTJzCs/s/-LEUwT7jCr-dMz6opcAJ/1.-installing-ushahidi)
* [Setting Up a Deployment](https://app.gitbook.com/o/-LEUwSacjzjxNiZTJzCs/s/-LEUwT7jCr-dMz6opcAJ/2.-setting-up-a-deployment)

Make sure you are logged in to your deployment page.

### Setup guide

#### Video tutorial for accessing surveys

{% embed url="<https://www.loom.com/share/0709d59919e34affa3e8e6678b33c683?sid=18402711-7ca0-42a1-a949-ab9ef5a6e576>" %}

To access the Surveys configuration page, on the sidebar, click on ***Settings***

<figure><img src="/files/7n2rXaN0MiKR4mgJSwC3" alt="Settings link highlighted in a Ushahidi deployment sidebar"><figcaption><p>Settings link highlighted in a Ushahidi deployment sidebar</p></figcaption></figure>

Then, click on ***Surveys***

<figure><img src="/files/zYPi9sZFuLYKnpcBK6Ch" alt="&#x22;Surveys&#x22; link in the deployment settings page."><figcaption><p>"Surveys" link in the deployment settings page.</p></figcaption></figure>

***

## 3.3.1 Building Surveys <a href="#id-3-3-1-adding-surveys" id="id-3-3-1-adding-surveys"></a>

By default, each deployment has a ***Basic Post*** survey, which can be deleted or modified as needed. To create a new survey:

#### Video setup guide for Building surveys

{% embed url="<https://www.loom.com/share/9aa545fcced245f58f33dd5627d54265>" %}

* Click on ***Add Survey*** as shown below.
* In the upper right corner of the survey form, you will see the default language that your deployment is currently in. Check [Chapter 3.3.2 ](https://docs.ushahidi.com/ushahidi-platform-user-manual/3.-configuring-your-deployment/3.3-surveys#3-3-2-configuring-surveys)**on how to change a survey's default language**
* Fill in the required details:
  * ***Survey Name:*** Try being as specific as possible when creating your survey name so that users will understand what they are selecting when creating new posts
  * ***Description:*** Provide a brief description of what kind of data you’ll be collecting with this survey
  * ***Fields + Tasks:*** See below for details on how to add fields and tasks into your survey.
  * Click on ***save*** once you're done building your survey.

<figure><img src="/files/9rWlQtYvjnQDXt2epxQp" alt="Add Survey button highlighted In the Surveys page."><figcaption><p>Add Survey button highlighted In the Surveys page.</p></figcaption></figure>

<figure><img src="/files/KhYb5Qz2G0ITGQGtngOI" alt="Change Surveys Default Language Drop Down Highlighted In The Add Survey Page to show on how to change a survey&#x27;s default language"><figcaption><p>Change Surveys Default Language Drop Down Highlighted In The Add Survey Page</p></figcaption></figure>

{% hint style="info" %}
See chapter 3.3.2 on how to translate your survey
{% endhint %}

***

#### Video setup guide for duplicate surveys

{% embed url="<https://www.loom.com/share/5a7bff751de94280b12251b2a98bff34?sid=6837a29c-eb6c-49f4-82ce-0df76ab53781>" %}

***To duplicate a survey***

On the ***surveys*** settings page where you have a list of surveys:

* Click on the ***bulk actions*** button
* Check/select the survey(s) you would like to duplicate
* Then click on the ***duplicate button or icon***.

<figure><img src="/files/MHQ3yySSDkzpqix54Kid" alt="Click on the Bulk Actions button and then select surveys to delete."><figcaption><p>Click on the Bulk Actions button and then select surveys to delete.</p></figcaption></figure>

<figure><img src="/files/U2Vjq91ml89LI6zgMXdb" alt="Click on the &#x22;Duplicate&#x22; button in the contextual bar. This will duplicate your survey."><figcaption><p>Click on the "Duplicate" button in the contextual bar. This will duplicate your survey.</p></figcaption></figure>

***

### 3.3.1.1 Fields

#### Video setup guide for managing fields

{% embed url="<https://www.loom.com/share/1634567574d84eaaa02dbd9c417ea5c0?sid=09f76b6c-dbbb-49c3-a5b3-4ad1950072fb>" %}

Each survey you create will have a title and description field by default. It's important to note these fields can be edited, ***but cannot be deleted***.

***

## Different Types Of Field

* **Short Text:  Short Text** field is designed for brief, single-line responses—typically a sentence or less. This field is particularly useful when you need concise information.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask a simple question like:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"What is the estimated water level during the flood?"**</mark>\ <mark style="color:orange;">Here, a Short Text field would capture specific, brief inputs like "3 feet" or "1 meter."</mark>

* **Long Text:  Long Text** field is ideal for capturing more detailed responses, such as paragraphs or multiple sentences. This field is perfect when you expect users to provide in-depth feedback or explanations.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"Can you describe the impact of the flood on your home and surroundings?"**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">In this case, the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Long Text**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">field would allow respondents to give a detailed response like:</mark> <mark style="color:orange;"></mark>*<mark style="color:orange;">"The flood caused significant damage to our home. The water reached the first floor, destroying furniture and appliances. Roads were also submerged, cutting off access to emergency services for several days."</mark>*

* **Number(Decimal):**  This field is designed to capture numerical inputs, which include decimal values. This field is useful when precise numerical data is needed.&#x20;

> <mark style="color:orange;">For example, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"What was the total cost of flood damage in dollars?"**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Here, the Number (Decimal) field ensures respondents can enter exact monetary figures like</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**1500.75**</mark><mark style="color:orange;">, making it easy to record detailed financial data.</mark>

{% hint style="info" %}
**Note: Number will not accept any kind of alphabet and Special symbol for example $.**
{% endhint %}

* **Number(Integer):** The number (Integer) field is designed to capture numerical inputs, which are whole numbers. This field can be useful for the answer which will obviously be a whole number.&#x20;

> <mark style="color:orange;">For example, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"What is your age?"**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Here, the Number field ensures respondents can enter the whole number as inputs.</mark>

{% hint style="info" %}
**Note: Both Number (Decimal & Integer) fields don't accept digits greater than 10, so respondents cannot add country codes if the field is requesting phone numbers.**
{% endhint %}

* **Location:** This field allows users to share geographic data. This field can provide a map interface, enabling respondents to select their location or manually input **latitude and longitude** coordinates. This is particularly useful when collecting precise location data.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"Please provide the exact location of the flood impact."**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">When using the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Location field**</mark><mark style="color:orange;">, a map will appear in the survey. Respondents can either click on the map to mark their location or can manually move the cursor on the map for exact</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**latitude and longitude**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">values, such as</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**28.6139° N, and 77.2090° E**</mark><mark style="color:orange;">. This data is valuable for creating accurate, location-based reports.</mark>

<figure><img src="/files/I05yTyDWUnw98F4Xc8Bi" alt=""><figcaption><p>Respondents view in survey form</p></figcaption></figure>

* **Date:** This field allows respondents to select a specific date, providing them with a calendar interface where they can adjust the **month, date, and year** according to their requirements. This is particularly useful when you need time-related information.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"When did the flooding start in your area?"**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Using the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Date Field**</mark><mark style="color:orange;">, respondents can open the calendar, navigate through the months and years, and select the exact date. The</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**default value will be the current date**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">when the form is filled, but users can easily modify it to reflect the appropriate date of the event.</mark>

<figure><img src="/files/VJlo7RrohCgSX8SaVSgL" alt=""><figcaption><p>Respondents view on survey form</p></figcaption></figure>

* **Date and Time Field:** This allows respondents to select both a specific **date** and the **exact time** using a calendar and time picker interface. This field is useful when you need precise information that includes both the day and the time of an event.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"When did the floodwaters start rising in your area?"**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Respondents can select the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**date**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">from the calendar and then adjust the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**time**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">by choosing the exact hour and minute, such as</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**August 15, 2024, 03:30**</mark><mark style="color:orange;">.</mark>&#x20;

<figure><img src="/files/AGYU2CqLfOrZ0Ir6HXt9" alt=""><figcaption><p>Respondents view on survey form</p></figcaption></figure>

* **Select:** This field provides respondents with a set of predefined options to choose from. These options are created by the admin. Respondents will see a **drop-down arrow**, which they can click to reveal the available choices. Only one option can be selected from the list.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**"What is your preferred method of receiving flood alerts?"**</mark>&#x20;
>
> <mark style="color:orange;">In the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Select Field**</mark><mark style="color:orange;">, respondents can click the drop-down and see options like:</mark>
>
> &#x20;               &#x20;**&#x20;**<mark style="color:blue;">**SMS**</mark>
>
> &#x20;                 <mark style="color:blue;">**Email**</mark>
>
> &#x20;                <mark style="color:blue;">**WhatsApp Message**</mark>

The respondent can then select the one option that best fits their preference.

<figure><img src="/files/ajdpEK6GKC5Gus4nB1tU" alt=""><figcaption><p>Respondents view on survey form</p></figcaption></figure>

* **Radio Button(s):** The **Radio Buttons Field** is similar to the **Select Field**, but the key difference is that all options are **visible on the form** itself, rather than being hidden in a drop-down menu. Respondents can view the options directly and select only one.&#x20;

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark>
>
> <mark style="color:orange;">**"What is your current living condition after the flood?"**</mark>
>
> <mark style="color:orange;">In the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Radio Buttons Field**</mark><mark style="color:orange;">, the options might appear like this:</mark>
>
> &#x20;        <mark style="color:blue;">**Staying at home**</mark>
>
> &#x20;        <mark style="color:blue;">**Temporarily relocated**</mark>
>
> &#x20;        <mark style="color:blue;">**In a shelter**</mark>
>
> &#x20;        <mark style="color:blue;">**With relatives**</mark>

The respondent can select the most accurate option by clicking the corresponding radio button.

<figure><img src="/files/5StSHdVW6sg35ACpeyzi" alt=""><figcaption><p>Respondents view on survey form</p></figcaption></figure>

* **Checkbox(es):**  These allow respondents to choose **one or more** options from a predefined set. Unlike radio buttons, where only one option can be selected, checkboxes enable users to select multiple options if applicable.

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood report survey**</mark><mark style="color:orange;">, you might ask:</mark>
>
> <mark style="color:orange;">**"Which resources do you currently need?"**</mark>
>
> <mark style="color:orange;">The</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Checkboxes Field**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">could have the following options:</mark>
>
> &#x20;          &#x20;**&#x20;&#x20;**<mark style="color:blue;">**Food**</mark>
>
> &#x20;            <mark style="color:blue;">**Water**</mark>
>
> &#x20;            <mark style="color:blue;">**Medical Supplies**</mark>
>
> &#x20;            <mark style="color:blue;">**Shelter**</mark>
>
> &#x20;            <mark style="color:blue;">**Clothing**</mark>

Here, the respondent can select multiple options based on their needs, such as both **Food** and **Water**.

<figure><img src="/files/dWAGAuh53HfAOyHsYXd6" alt=""><figcaption><p>Respondents view on survey form</p></figcaption></figure>

* **Related Post:** The **Related Post Field** allows you to create a connection between different surveys by linking relevant posts. This is particularly useful for cross-referencing data from various surveys. However, it’s important to note that only posts that have been **published** will appear in the search results when linking; posts that are **"Under review"** will not be visible for selection.

> <mark style="color:orange;">For example, in a flood report survey, you might want to relate a previous disaster preparedness survey to understand how preparedness impacted the flood response. Using the Related Post Field, you can link the two surveys, enabling easy access to relevant data across surveys.</mark>

* **Image:** The **Image Field** allows users to upload images to the post, with a maximum file size of **10.00 MB**. To add an image, respondents can click the **Add photo** button and select the desired image from their device. Additionally, there's an option to include a **caption** for the image, allowing users to provide a brief description or context for the uploaded photo.

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood damage report**</mark><mark style="color:orange;">, respondents could upload images showing the extent of the flood's impact and add captions like:</mark>\
> \&#xNAN;*<mark style="color:orange;">"Floodwaters reaching up to 3 feet in the living room."</mark>*

<figure><img src="/files/Z2qUUHGD8CNb6iDOlwcm" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note: Always add an image, if you add a caption.  Respondents can't submit the form by adding only a caption WITHOUT uploading the image.**
{% endhint %}

This feature is particularly useful when visual documentation is needed to support the report.

* **Embed Video:** The **Embed Video Field** allows users to embed videos from platforms such as **YouTube** or **Vimeo** directly into the post. Respondents simply need to paste the video link (URL) into the provided field. This feature is useful for sharing visual content that supports the post or survey data.

> <mark style="color:orange;">For example, in a</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**flood damage report**</mark><mark style="color:orange;">, respondents could include a YouTube video showing the flooding in their area. This allows for more dynamic and detailed reporting, providing a clearer visual context alongside written information.</mark>

<figure><img src="/files/VRnH1O9FUuR2bMyUieRg" alt=""><figcaption><p>Respondents view on survey form</p></figcaption></figure>

***

### 3.3.1.1.1 Adding Fields

You can add as many custom fields to your survey as you see fit. To add a new field, click on the ***Add Field*** button.

<figure><img src="/files/ZZpTrtRcoJ7Q1tSbVBJl" alt="Click On Add Field Button To add custom fields In the survey."><figcaption><p>Click On Add Field Button To add custom fields In the survey.</p></figcaption></figure>

A pop-up box with a list of different field types will appear on your screen. Choose whichever one will work best for the type of data you are trying to capture.

<figure><img src="/files/epfbHM5JiblT5m6YLL7W" alt="A pop-up box with a list of different field types ,such as short text, long text, location, number, date, date &#x26; time, select - a drop down list of items."><figcaption><p>"Add field" modal displaying a list of different field types</p></figcaption></figure>

***Add the following details for which ever field type(s) you select:***

* ***Name:*** This is what is displayed as a label for your newly created field
* ***Add field description (optional):*** A visual editor should appear below, you may add help text that provides additional details about this field.
  * Add some text in the description-editor, format it however you want to, and as long text as you want to.
* ***Required:*** If set to yes, post submission will be only be successful once this field has been filled out. If set to no, post submission will be successful even if it has not been filled out.
* ***Make responses private***: This allows limiting access to responses to this field to specific users.
* ***Default Value:*** You can set a default value displayed every time someone is creating a new post. example, a survey asks whether you want to subscribe to a service, and it has a default value of 'No'.\
  If you submit without changing this value, the default value will be submitted as 'No' when you save the survey. If you change to 'Yes', the value that will be submitted will be 'Yes'. That's the value that will be submitted when the survey is saved.\
  \&#xNAN;***Note: For fields where it's possible to add a default value (all field-types except "image", and "categories"), the default value box should be displayed with no toggle-switch***
* ***Field Options:*** This appears in cases where you’re creating a checkbox, select or radio button field. You can add as many options as you would like.
* Once you’re done, click on ***Save.***

<figure><img src="/files/LelXSrjQR9EO3DiFFppo" alt="Adding a field form with name, field description fields, highlighting required and make responses private toggle button."><figcaption><p>Adding a field form with name, field description fields, highlighting required and make responses private toggle button.</p></figcaption></figure>

***Note that, the description should have the same formatting as it did in the field description editor.*** To confirm thi&#x73;***:***&#x20;

* Add a new post to this survey you just created
* Save the post
* Go to data view
* Select the post you added and select "edit"
* The field description you added will be visible.
* The description should have the same formatting as you did in the editor

***

### 3.3.1.1.2 Editing Fields

#### Video Setup Guide for Editing Fields

{% embed url="<https://www.loom.com/share/b883abdc1347454294f4cebb936bfac6?sid=3cbe23a4-c3eb-4d2a-bc1b-72cc05f18b3d>" %}

To edit an existing field:&#x20;

* Select the desired custom field by clicking on it
* Edit the fields (as described in the section above on [Adding fields](/platform-user-manual/3.-configuring-your-deployment/3.3-surveys.md#33111-adding-fields)) as desired.
* Click on ***Update*** when done.

<figure><img src="/files/fwUV3R9bAUoa84ml3GfO" alt="Editing a survey&#x27;s fields.Highlighted field: Location"><figcaption><p>Editing a survey's fields.Highlighted field: Location</p></figcaption></figure>

<figure><img src="/files/GGnCdKwdAQgu82XXX1dU" alt="Modal with field editor. Edit the field name and display options."><figcaption><p>Modal with field editor. Edit the field name and display options.</p></figcaption></figure>

***

You can also change the position of existing fields by dragging the field with the scroll icons to the left of every field as shown below.

<figure><img src="/files/quge6K1yliGSdayYTSGz" alt="Sorting the fields of a survey with Up and Down arrow in the survey editor."><figcaption><p>Sorting the fields of a survey with Up and Down arrow in the survey editor.</p></figcaption></figure>

***

### 3.3.1.1.3 Deleting Fields

#### Video setup guide for Deleting Fields

{% embed url="<https://www.loom.com/share/bcb8895a213d469081cacaeda1a3309e?sid=3654c21e-04b7-4cdf-965b-6b0a1669cf5c>" %}

To delete an existing field

* Click on the trash icon adjacent to the field you'd like to delete.
* A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete the field
  * Click on ***Delete*** to delete the field
  * If you’d like to cancel the field deletion process, click on Cancel

<figure><img src="/files/etxpBPUqOO2QZF5uBOPm" alt="Deleting survey fields with the &#x22;trash&#x22; icon in the survey editor."><figcaption><p>Deleting survey fields with the "trash" icon in the survey editor.</p></figcaption></figure>

<figure><img src="/files/o4C3vL1FwS3i9oZB1pLK" alt="A popup warning will be displayed before deleting a field."><figcaption><p>A popup warning will be displayed before deleting a field.</p></figcaption></figure>

***

### 3.3.1.2 Tasks

You can organize your survey into “Tasks”, allowing a deployment to add fields related to actions that need to be taken, like translation or verification. These groups of tasks are visible to specified users and can be marked as ‘complete.’ For example, if a particular survey requires verification upon submission, you can design a task to ensure your team knows the post needs to be verified before publishing. The task could include fields like whether the information was verified or not, who verified the information, how they verified it, and when they verified it. After verification, the task can be marked as complete and the post can either be moved to the next task if necessary, or published.

### 3.3.1.2.1 Building Tasks

#### Video setup for Building Tasks

{% embed url="<https://www.loom.com/share/1d706a563f434450866a0e60fcc92a75?sid=db5aec11-4325-45f7-b009-d2a1ed68c0e7>" %}

To add a new task:

* Click on Add Task on your survey creation/edit page
* A small pop up box will appear, prompting you to give your task a name
* If you’d like to make this task required before post submission, switch on the ***Require this task be completed before a post can be visible to the public*** toggle. This means that, a post will not be published until this task is marked as complete
* Click on ***Add***

<figure><img src="/files/0qaXX0ungOFwzCzSINRR" alt="Click On Add Task Button To add custom fields In the survey."><figcaption><p>Click On Add Task Button To add custom fields In the survey.</p></figcaption></figure>

<figure><img src="/files/SIGwExm8eakryumihdAk" alt="Add task modal displaying a form with &#x22;Task name&#x22;, &#x22;Task description&#x22; and task completion requirements."><figcaption><p>Add task modal displaying a form with "Task name", "Task description" and task completion requirements.</p></figcaption></figure>

**Once set up, you can duplicate your task as follows. Adding task fields**

You should be able to add fields to tasks in the same way that you add fields to a survey.

<figure><img src="/files/8ypsDL6iPM5XM6WvgePL" alt="Highlighted Add Fields button to tasks in the survey editor."><figcaption><p>Highlighted: Add Fields button to tasks in the survey editor.</p></figcaption></figure>

Please refer to the [Fields section](/platform-user-manual/3.-configuring-your-deployment/3.3-surveys.md#3311-fields) of this manual for details on how to add, edit, and delete task fields.

***

### 3.3.1.2.2 Configuring tasks

#### Video setup for Configuring tasks

{% embed url="<https://www.loom.com/share/c269033191914efcb666b4072788e5cb?sid=a4f6c86a-d842-42b8-a6c1-9103b282d7a7>" %}

To make additional configurations to your task, click on the ***Configure*** tab

<figure><img src="/files/97k3GxqUzKgbyZmo4yGl" alt="A popup modal with Highlighted: Configure Tab for additional configurations"><figcaption><p>A popup modal with Highlighted: Configure Tab for additional configurations</p></figcaption></figure>

***

***Set the following options***

* \_**Required:** \_When set to yes, this task must be set as complete for successful post-submission
* ***Task is only for internal use:*** This limits the visibility of this task during submission only to teams with permissions to manage posts on your deployment i.e only internal team members will be able to submit responses to this task
* \_**Show this task to everyone when published:** \_This limits the visibility of task responses when viewing submitted posts if not enabled i.e. it limits the visibility of responses to tasks to internal teams only.

<figure><img src="/files/Df3qKGS4PJkjrZv85scL" alt="Survey task options highlighted in the tasks editor. Highlighted 3 toggle buttons, Required, This task is only for internal use, Show this task to everyone when published"><figcaption><p>Survey task options highlighted in the tasks editor.</p></figcaption></figure>

This is what it would look like when applied to your survey form later on:

<figure><img src="/files/t0XjBvSC4uHMGv3sJmw3" alt="A page showing an Example of a Task. Highlighting task name, task completed off toggle button, location and task description."><figcaption><p>A page showing an Example of a Task</p></figcaption></figure>

***

### **3.3.1.2.3 Editing Tasks**

To edit an existing task:

* Scroll down to the desired task
* Make changes as desired, e.g changing the task name, description, and/or making a task required or not
* When done, click on ***Save*** at the bottom of the page

<figure><img src="/files/QvYzwVyunzYRYfwMcPJl" alt="Editing a survey&#x27;s tasks. Build, configure and edit the task fields."><figcaption><p>Editing a survey's tasks. Build, configure and edit the task fields.</p></figcaption></figure>

***

### 3.3.1.2.4 Deleting Tasks

#### Video setup for deleting tasks

{% embed url="<https://www.loom.com/share/53c64ec73c0a4f8aafa62c77263b6ffb?sid=5650136a-6735-4d59-835d-e3dcdefe2cea>" %}

To delete an existing task

* Scroll down to the desired task
* Select ***Delete Task*** button

***

## 3.3.2 Translating Surveys

Once the survey form has been created and all the required fields have been filled, you can translate the survey into other languages if you want to. Below are a video and written setup guides to help you.

**Note: You can add more than one language**

***

#### Written Setup Guide

* Click on ***Add translation*** at the upper right-hand corner of the survey form.

<figure><img src="/files/rGHB5tB5pjLsHmg27xiI" alt="Edit Survey page with arrow in red pointing to Add Translation button"><figcaption><p>Edit Survey page arrow in red pointing to Add Translation button</p></figcaption></figure>

***

* A pop-up module will appear on your screen, select the language(s) you want to translate to using the checkboxes beside the language names.

<figure><img src="/files/X55LxuA987uWuJXLBAnf" alt="Choose Language Translation Page with a list of checkboxes of available languages to choose from. Select the language to translate your content into"><figcaption><p>Select the language to translate your content into</p></figcaption></figure>

***

Then:

* Click on ***Add*** to finish.
* You will be redirected to a survey form with the translatable content in the default language and fields where you can add your translations
* On the empty fields, translate the survey details into the chosen language e.g in the above image the default language is English and the added language is French.

<figure><img src="/files/EGIzxVWgD5nYtLo6AO59" alt="Chosen language in this example is French. French language is chosen in the drop down menu."><figcaption><p>Chosen language in this example is French</p></figcaption></figure>

On the survey, you will then be able to see the available languages that the survey has been translated into.

<figure><img src="/files/3p0aVw8jrUZh1EWc95Wf" alt="Available languages that the survey has been translated into.Languages drop down menu is highlighted."><figcaption><p>Available languages that the survey has been translated into.</p></figcaption></figure>

Similarly you can see this translate dropdown to select a language to translate to on the post edit form in the data view:

<figure><img src="/files/AI94GDunzmgoNuMxJMAZ" alt="Available languages that the survey can be translated to in Edit Post section.Languages drop down menu is highlighted."><figcaption><p>Available languages that the survey can be translated to in Edit Post section</p></figcaption></figure>

***

### 3.3.2.1 **Translating Fields**

To translate the added fields on your survey;

* Scroll down to fields.
* Select the desired custom field by clicking on the edit button icon that is on it.
* A pop-up module will appear. Translate the field details to the chosen language.

<figure><img src="/files/5RFsHFoEI8kTSYcu13de" alt="Selecting the title and description field for translation"><figcaption><p>Selecting the title and description field for translation</p></figcaption></figure>

<figure><img src="/files/M38tC7xQM69vR5nwtr0p" alt="Translating the name field."><figcaption><p>Translating the name field</p></figcaption></figure>

Translate the remaining fields that you added.

***

### **3.3.2.2 Translating Tasks**

To translate tasks:

* Scroll down to tasks.
* Translate the task details.\
  You should be able to translate the task fields in the same way that you translated the fields in the surveys. ***Please refer to the Fields section of this manual for details on how to translate task fields***.&#x20;
* Click Save when all is done.

<figure><img src="/files/OiuYVdxRy0w4IRQbVlSy" alt="Translate the task name and description on the empty fields as shown above."><figcaption><p>Translate the task name and description on the empty fields as shown above.</p></figcaption></figure>

***

## 3.3.3 Configuring Surveys

You can add additional configurations to your survey e.g setting a survey color etc. To do so, click on ***Configure*** on the top of the survey editor.

<figure><img src="/files/TL7ijpuBLrCcKuGiOCei" alt="Using the &#x22;Configure&#x22; tab in the survey editor."><figcaption><p>Using the "Configure" tab in the survey editor.</p></figcaption></figure>

***

***Configure the settings to suit your needs***

* ***Require posts be reviewed before they’re published:*** When toggled on, posts submitted on your deployment will not be made public i.e accessible to anyone beyond your internal team, until it is reviewed ( It will remain in draft). Setting this option off will automatically publish all posts submitted on your deployment.&#x20;
* ***Hide author information:*** When toggled on, this option hides author information e.g phone numbers, twitter handles and email addresses of people who submit posts to your deployment from the public. \
  \&#xNAN;***Note: logged in users with permission to manage posts will still be able to see  author information.***
* ***Hide exact location information:***  When toggled on, this option hides the exact location of posts on the map. Only the people with the permission to edit will be able to see exact locations, those without permission will only able to see rounded locations. The locations will be accurate to 0.1 km.
* ***Hide exact time information:*** When toggled on, only people with permission to edit responses will be able to see exact time submitted. Other people will see only the date.
* \_**Who can add to this survey:**\_You can limit submission of posts to your survey by roles. By default, surveys are open to the general public for submissions, and not limited to internal roles.&#x20;
* ***Color:*** Select a color or input a specific hex value to choose which color will be associated with this survey. Pins on the map will match whichever color you select.
* **Select default language for this survey:** Click on the dropdown menu to choose the default language. This will be changing the language of the deployment that is currently in.
* Click on ***save*** once your configuration options are complete

<figure><img src="/files/ZlrUIOXKaEZmCSMC6P4q" alt="Using the &#x22;Configure&#x22; tab in the survey editor. Highlighting the color field, default language field and two radio buttons."><figcaption><p>Using the "Configure" tab in the survey editor.</p></figcaption></figure>

***

## 3.3.4 Sharing Surveys

Ushahidi provides the ability to ***Share*** your survey across multiple platforms. Share via:

* ***Web address:*** Copy and paste this link to direct people to your survey form
* ***Facebook:*** Share the survey form on Facebook
* ***Twitter:*** Share the survey form on Twitter
* ***Embed:*** Copy and paste this HTML block of code to embed the survey form on any site across the web

<figure><img src="/files/BzQ9NEJzi8Gm01ivxeNv" alt="Sharing surveys across Facebook, Twitter and Embed methods. "><figcaption><p>Sharing surveys across Facebook, Twitter and Embed methods. </p></figcaption></figure>

***

## 3.3.5 Editing surveys <a href="#id-3-3-2-editing-surveys" id="id-3-3-2-editing-surveys"></a>

To edit a survey:

* Click on a survey from the list of surveys on your page.
* From here, change your survey details as desired then click on ***Save.***

<figure><img src="/files/tWRIr5BaCJgm4AqCrISn" alt="Selecting a survey to edit it from the list of surveys"><figcaption><p>Selecting a survey to edit it from the list of surveys</p></figcaption></figure>

***

## 3.3.6 Deleting surveys <a href="#id-3-3-3-deleting-surveys" id="id-3-3-3-deleting-surveys"></a>

On the ***surveys*** settings page where you have a list of surveys:

* Click on the ***bulk actions*** button
* Check/select the survey(s) you would like to delete
* Then click on the ***delete button or icon***.

<figure><img src="/files/MHQ3yySSDkzpqix54Kid" alt="Click on the Bulk Actions button highlighted and then select surveys to delete."><figcaption><p>Click on the Bulk Actions button highlighted and then select surveys to delete.</p></figcaption></figure>

<figure><img src="/files/29ySWjpkYYVOApTVSAvq" alt="Select surveys and then select &#x27;Delete&#x27;. Delete Button and two checked check boxes for surveys are highlighted."><figcaption><p>Select surveys and then select 'Delete'</p></figcaption></figure>

A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete the survey and all its data.

* Click on **Yes, delete** to delete the survey
* If you’d like to cancel the survey deletion process, click on ***No, go back.***\
  \
  ***Note: Once you delete your survey all its data and posts will be deleted . This cannot be undone, so take caution when you perform this action.***

<figure><img src="/files/aeqvFVNH9WPOq9gmn1YH" alt="Delete Modal - By deleting a survey, all posts under it will be deleted"><figcaption><p>Delete Modal - By deleting a survey, all posts under it will be deleted</p></figcaption></figure>