> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/notifications/feedback-survey.md).

# Product feedback survey

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/notifications/feedback-survey.md).
{% endhint %}

Four questions from the Snapfix product team: how the user would feel without Snapfix, who would benefit most, the main benefit, and how Snapfix can improve. The screen never opens in the current app \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].

**Not shown in the current app.** It opens only from the same survey check as the [NPS survey](https://docs.snapfix.com/how-the-apps-work/screens/notifications/nps-survey.md), whose only trigger is commented out; that page says how the check is switched off and what replaced it (ios @ aa31967ac8, `SnapFix/BusinessListingVC.swift:1458`, `:3141-3151`).

* **Where:** iOS: over the [group list](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-list.md), when the survey check finds a product feedback survey due (`survey` "pmfs").
* **Who:** nobody today. The server would choose who is due; the app checks no role.
* **Feature:** [Feedback surveys](https://docs.snapfix.com/product/features/notifications/feedback-surveys.md). The [pre-registration survey](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/pre-registration-survey.md) is a different screen.

## Layout

The survey has six steps, each shown over the dimmed group list. A cross at the top right of every step closes the whole survey.

```mermaid
flowchart LR
  start["Start"] -- "Start" --> q1["Question 1 (1/4)"]
  q1 -- "Continue" --> q2["Question 2 (2/4)"]
  q2 -- "Continue" --> q3["Question 3 (3/4)"]
  q3 -- "Continue" --> q4["Question 4 (4/4)"]
  q4 -- "Done" --> done["Thank you"]
```

1. **Start** (`SnapFix/Storyboards/PMFS.storyboard:24-222`): "We like to hear your feedback"; "Today we have 4 simple questions for you, and it will only take seconds to complete."; a short note from Snapfix's product manager, with a photo and a signature, which ends "I would really love to hear your feedback. It will help us make Snapfix better, faster and simpler." and "Thank you for using Snapfix."; "Start"; and "Ask me another time", whose title the code sets from the string file (`SnapFix/PMFS/PMFSStartVC.swift:27`).
2. **Question 1** (`:224-404`): "1. How would you feel if you could no longer use Snapfix?"; the choices "Very disappointed", "Somewhat disappointed" and "Not disappointed"; the page count "1/4"; and "Continue".
3. **Questions 2 to 4** (`:406-566`; `SnapFix/PMFS/PMFSSurveyVC.swift:12-47`): one step each, with the question, a text box with a counter "n/500" below it, the page count "2/4", "3/4" or "4/4", and "Continue", or "Done" on question 4. The questions are "2. What type of people do you think would most benefit from Snapfix?", "3. What is the main benefit you receive from Snapfix?" and "4. How can we improve Snapfix for you?".
4. **Thank you** (`:568-640`): "Thank you for helping us make Snapfix better, faster and simpler." with "We appreciate your feedback!" below it, a check-mark animation that plays once, and "Close".

## Inputs

| Field                                                       | Type                 | Required                      | Default | Rules and messages                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------- | -------------------- | ----------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "1. How would you feel if you could no longer use Snapfix?" | One of three choices | Yes, for "Continue"           | None    | Choosing one clears the others. "Continue" stays off until one is chosen. Sent as `01-feel`, as the English text of the choice whatever the app's language (`SnapFix/PMFS/PMFSRatingVC.swift:33-36`, `:51-71`; `SnapFix/PMFS/PMFSBaseVC.swift:28-32`).                   |
| Questions 2 to 4                                            | Text, several lines  | Yes, for "Continue" or "Done" | Empty   | Up to 500 characters; typing stops at 500. "Continue" and "Done" stay off while the box is empty, but a box of spaces counts as an answer and is sent as typed (`SnapFix/PMFS/PMFSSurveyVC.swift:83-103`, `:155-165`). Sent as `02-type`, `03-benefit` and `04-improve`. |

## Actions

| Action                                | Who                          | What happens                                                                                                                                                                                                                                                                             | API                                                                                                                                             |
| ------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| "Start"                               | A user the survey opened for | Opens question 1 (`SnapFix/PMFS/PMFSStartVC.swift:38-42`).                                                                                                                                                                                                                               | None                                                                                                                                            |
| "Ask me another time"                 | Same                         | Closes the survey, then sends `remind_me_later` 1 with `survey` "pmfs" (`PMFSStartVC.swift:44-48`; `SnapFix/PMFS/PMFSBaseVC.swift:66-84`).                                                                                                                                               | php-apis `?action=survey_feedback`, in the [Notifications API](https://docs.snapfix.com/engineering-reference/api/notifications.md) (no caller) |
| Cross (start or a question)           | Same                         | Closes the survey, then sends `user_dismiss` 1. The answers given so far are not sent (`PMFSStartVC.swift:32-36`; `SnapFix/PMFS/PMFSRatingVC.swift:44-49`; `SnapFix/PMFS/PMFSSurveyVC.swift:123-128`).                                                                                   | As for "Ask me another time"                                                                                                                    |
| "Continue"                            | Same                         | Opens the next question; the answer stays in memory (`PMFSRatingVC.swift:73-80`; `PMFSSurveyVC.swift:130-145`).                                                                                                                                                                          | None                                                                                                                                            |
| "Done" (question 4)                   | Same                         | Sends the four answers as `survey_data`. On success the thank-you step opens. A refused answer shows the server's message in a toast, and any other failure "Something went wrong. Please try again."; question 4 stays open (`PMFSSurveyVC.swift:146-150`; `PMFSBaseVC.swift:116-134`). | As for "Ask me another time"                                                                                                                    |
| "Close" or the cross (thank-you step) | Same                         | Closes the survey (`SnapFix/PMFS/PMFSCompletedVC.swift:38-53`).                                                                                                                                                                                                                          | None                                                                                                                                            |
| Survey check                          | The app (never today)        | As for the [NPS survey](https://docs.snapfix.com/how-the-apps-work/screens/notifications/nps-survey.md#actions); this survey opens when the answer is `pmfs`, the survey is pending and the device's time is inside the window (`SnapFix/BusinessListingVC.swift:3078-3092`).            | php-apis `?action=survey_check`, in the [Notifications API](https://docs.snapfix.com/engineering-reference/api/notifications.md) (no caller)    |

## States

* **Loading:** none. Each step appears at once.
* **Empty:** none.
* **Error:** a failed "Done" shows a toast and stays on question 4 ([Actions](#actions)).
* **No permission:** none. The server decides who gets the survey.
* **Offline (mobile):** the check does not run. "Done" does nothing and shows nothing; the answers stay on screen and are not kept for later. "Start", "Continue" and the crosses still work, but nothing is sent (`PMFSBaseVC.swift:116-134`).

## Dialogs and sheets

None. Each step is a view pushed over the previous one inside one survey screen.

## Platform differences

iOS only. Android has the same four questions, with the same wording and answer keys (`01-feel` to `04-improve`), as a bottom sheet (`PMFSBottomSheet`), but no code creates it (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/bottomSheet/PMFSBottomSheet.java:43-51`, `:272-283`; `app/src/main/res/values/strings.xml:1691-1695`, `:1868-1869`). Its survey check is off, as for the [NPS survey](https://docs.snapfix.com/how-the-apps-work/screens/notifications/nps-survey.md#platform-differences).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/notifications/feedback-survey.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
