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

# Take Survey

> Employee self-service page for completing an assigned engagement survey, with partial-save support and resume capability for in-progress responses.

The Take Survey page allows an employee to complete an assigned engagement survey using an embedded form, with support for partial completion and resuming an in-progress response. It is served at route `/hr/engagement/surveys/:id/respond`.

## Overview

The page resolves the current user's employee record to obtain `employeeId`, then checks eligibility via `useCanStartSurvey`. Survey content renders via `FormEmbed`. Response state (create/submit) is managed by `useSurveyResponseMutation`. On successful submission, a completion state is shown. Ineligible users or loading errors display appropriate messages.

This page is part of the HR-17 Employee Engagement feature.

## Who it's for

Access follows your organization's role and module configuration. Eligibility is enforced by the `useCanStartSurvey` hook.

## Before you start

* The survey must be in `active` status.
* The current user must have an associated employee record in the organization.

## Steps

1. Navigate to the survey respond link (e.g., from an email notification or the My Surveys page) or go directly to `/hr/engagement/surveys/:id/respond`.
2. If eligibility is confirmed, the survey form renders.
3. Complete the questions. Partial responses may be saved automatically.
4. Click **Submit** to finalize the response.
5. A confirmation screen is shown on successful submission.

## Key concepts

| Term         | Meaning                                                                                        |
| ------------ | ---------------------------------------------------------------------------------------------- |
| Eligibility  | Determined by `useCanStartSurvey`; ineligible users see a blocking message.                    |
| FormEmbed    | Platform form rendering component that handles question display and input capture.             |
| Partial save | In-progress response persisted server-side; can be resumed. SME: confirm persistence behavior. |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr/engagement-routes.tsx
  * src/cores/hr/engagement/pages/SurveyResponsePage.tsx
  * src/cores/hr/engagement/hooks/useSurveyResponseMutation.ts
  * src/cores/hr/engagement/hooks/useMyActiveSurveys.ts
</Accordion>