> ## Documentation Index
> Fetch the complete documentation index at: https://support.fieldko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot Surveys

> Find out why the wrong survey shows on a task, why a question has two answers, why answers are missing, and which survey date to use in reports.

Use this page when survey results in the FieldKo Atlas app or in Salesforce reports don't look right. Each section explains why it happens and how to fix it.

## User Permissions Needed

| To do this | You need |
| - | - |
| View tasks, task surveys, and survey answers | Read access to **Tasks**, **Task Surveys**, and **Task Survey Answers**, such as from the **FieldKo Manager Permission Set** |
| Change surveys, task types, and visit templates | **FieldKo Manager Permission Set** |

## How a Task Gets Its Survey

Each task that opens a survey has one **Task Survey** record, which links the task to a survey and holds the rep's answers. FieldKo sets the survey when the task is created:

| Task Created By | Survey Comes From |
| - | - |
| A rep adding a task in the app | The task type's **Default Survey**, unless the rep picks another one |
| A visit template | The survey on the template entry |
| A field campaign | The survey on the campaign's task |
| A recurring or cloned visit | The survey on the visit it was copied from |

After that, the task keeps its survey. Changing a task type's **Default Survey** doesn't change tasks that already exist.

## Why Is the Wrong Survey Showing?

**Problem or symptom:** A rep opens a task and sees an old survey, or a different survey from the one on the task type.

**Applies to:** FieldKo Atlas app; Salesforce admins.

**Why it happens:**

* The task was created before you changed the task type's **Default Survey**.
* The visit was copied from another visit, such as a recurring visit or **Clone Call Plan**, so it kept the old survey.
* The visit template entry or field campaign task still names the old survey.
* The rep picked a different survey when they added the task in the app.

**How to investigate:**

1. Open the task in Salesforce, and then open its **Survey Answers** (Task Survey) record. Check **Survey**.
2. Compare the task's **Created Date** with when you changed the survey.
3. If the visit came from a template or campaign, check the survey on the template entry or campaign task.

**How to resolve:**

* Update the survey on visit templates and field campaign tasks, as well as on the task type.
* For visits that are still **Not Started**, remove the task and add it again.
* To stop reps choosing another survey in the app, turn on **Make Survey Selection Read Only**, available in newer package versions. See [Configuration Reference](https://support.fieldko.com/admin/configuration-reference.md).

**Expected result:** Tasks created after your change open the new survey once the rep syncs.

**Escalation:** If a task created after your change still shows the old survey, email FieldKo support at [support@fieldko.com](mailto:support@fieldko.com) with the task name and the survey you expected.

**Related articles:** [Change a Survey That Reps Already Use](https://support.fieldko.com/admin/surveys.md#change-a-survey-that-reps-already-use)

## The Task Has No Take Survey Button

**Problem or symptom:** A task that should open a survey has no **Take Survey** button in the app.

**Applies to:** FieldKo Atlas app; Salesforce admins.

**Why it happens:** The task's survey is **Inactive**, or it hasn't reached the rep's device yet. The app opens only active surveys that are on the device.

**How to investigate:** Open the task's **Survey Answers** (Task Survey) record and check its **Survey**, and that survey's status.

**How to resolve:**

1. Set the survey to **Active**, or change the task to an active survey.
2. Ask the rep to sync.

**Expected result:** **Take Survey** appears on the task.

**Escalation:** If the survey is active and the rep has synced, email FieldKo support at [support@fieldko.com](mailto:support@fieldko.com) with the task name.

## Why Do I See Two Different Answers to the Same Question?

**Problem or symptom:** A report grouped by **Question Definition** shows 2 or more answers to one question for the same visit.

**Applies to:** Survey reports in Salesforce.

**Why it happens:** FieldKo saves one **Task Survey Answer** each time a question appears to the rep. A question appears more than once when:

* It's added to the survey **and** linked as a follow-up question, so the rep sees it twice.
* It's a follow-up question under more than one parent question or option.
* The visit has 2 tasks whose surveys both include the question.

**How to investigate:**

1. Add **Parent Answer**, **Answer Index**, and **Task Survey** to the report.
2. An answer with **Parent Answer** filled in is a follow-up. Answers on different task surveys come from different tasks.

**How to resolve:**

* Remove follow-up questions from the survey's own question list. Keep them only as follow-ups. See [Build Surveys](https://support.fieldko.com/admin/surveys.md#create-a-question).
* To report on follow-up answers separately, filter on **Parent Answer** being blank or not blank.
* To count one answer per task, group by **Task Survey** as well as by question.

**Expected result:** Each question shows once per task survey, or each extra answer is explained by its parent answer or task.

**Escalation:** If neither cause applies, email FieldKo support at [support@fieldko.com](mailto:support@fieldko.com) with links to the answer records.

## Survey Answers Are Missing

**Problem or symptom:** A rep says they did the survey, but answers aren't in Salesforce, or some questions have no answer.

**Applies to:** FieldKo Atlas app; Salesforce admins and managers.

**Why it happens:**

* **The survey hasn't synced.** Answers save on the device and upload at the next sync.
* **The rep left a draft.** A draft stays on the device until the rep taps **Save** or **Save Partially**. Logging out or running **Reset Sync** deletes it.
* **The question wasn't answered.** FieldKo creates an answer record only for questions the rep answered. Optional questions left blank have no record.
* **A follow-up no longer applies.** If the rep changed a parent answer, follow-up answers that no longer apply are deleted.
* **The task's survey record was replaced.** When a task gets a new **Task Survey** record, FieldKo deletes the old one and its answers.

**How to investigate:**

1. Ask the rep to open the [Sync screen](https://support.fieldko.com/sync/sync-screen.md) and check **Pending Changes**, and to reopen the survey to see whether it restores a draft.
2. In Salesforce, open the task's **Survey Answers** (Task Survey) record and check its status and answers.

**How to resolve:**

* If changes are pending, ask the rep to sync.
* If the rep has a draft, ask them to open the survey and tap **Save** or **Save Partially**, and then sync.
* If the rep's data is stuck, ask them to [send their data to FieldKo support](https://support.fieldko.com/troubleshooting/send-data-to-support.md) before they log out or reinstall.

> [!WARNING]
>
> Don't ask a rep with unsynced survey answers or drafts to log out, run **Reset Sync**, or reinstall the app. Their answers are deleted.

**Expected result:** Answers appear on the Task Survey after the rep syncs.

**Escalation:** Email FieldKo support at [support@fieldko.com](mailto:support@fieldko.com) with the rep's username, the visit, and the task.

## Which Survey Date Should I Use in Reports?

Survey records carry several dates, and they mean different things:

| Field | Object | What It Means |
| - | - | - |
| **Completion Date** | Task Survey | The date the rep completed the survey, from their device. Empty until the survey is complete. |
| **Planned Start** | Visit | When the visit was planned |
| **Created Date** | Task Survey Answer | When the answer reached Salesforce, which can be days after the visit if the rep synced late |

To report on when surveys were done, filter on the Task Survey **Completion Date** or the visit's dates, not the answer's **Created Date**.

## See Also

* [Build Surveys](https://support.fieldko.com/admin/surveys.md)
* [Design Surveys and Tasks for Reporting](https://support.fieldko.com/platform/customize/design-surveys-for-reporting.md)
* [Complete a Survey](https://support.fieldko.com/visits/surveys.md)
* [Fix Sync Errors](https://support.fieldko.com/troubleshooting/sync-errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.