FairMatch Codes

Generate unique, short reference codes for respondents on survey completion. FairMatch codes are simple alphanumeric identifiers that respondents can note for their records or use as a reference when contacting support.

Quick Start

Enable FairMatch in two steps:

1. Open Completion Settings - Open your survey and navigate to Completion Settings in the sidebar
2. Enable the toggle - Turn on "Show FairMatch Code"

FairMatch codes are automatically generated when respondents complete the survey.

What is FairMatch?

FairMatch generates a unique 4-character reference code for each survey response:

How It Works

When a respondent completes a survey with FairMatch enabled:

1. A random 4-character code is generated (e.g., SRVY-A7K2)
2. The code is displayed on the thank-you page
3. The code is stored with the response
4. The code appears in exports and API responses

Use Cases

Reference for Support

Respondents can use their FairMatch code when contacting support about their response:

Example:

"I completed your survey but had a question about my answer.
My code is SRVY-7X9K."

Attribution Tracking

Use FairMatch codes as a simple attribution mechanism:

Example:

Respondent completes survey → Code SRVY-A7K2
Respondent shares code with researcher
Researcher can look up the response using the code

Setting Up FairMatch

Enabling FairMatch

1. Open your survey and navigate to Completion Settings in the sidebar
2. Toggle on "Show FairMatch Code"
3. Save your changes

When enabled, respondents will see their FairMatch code (e.g., SRVY-A7K2) on the thank-you page after completing the survey. The code can be copied with a single click.

Using FairMatch Data

In Exports

FairMatch codes appear as a column in all export formats (CSV, Excel, SPSS):

response_id,fairmatch_code,q1_answer,q2_answer
resp_001,SRVY-A7K2,Yes,5
resp_002,SRVY-B3L8,No,3
resp_003,SRVY-C5P2,Yes,4

In API Responses

FairMatch codes are included in the API response data when fetching responses.

Real-World Examples

Example: Support Reference

Scenario: Respondent contacts support about their response.

Support request:
"I completed your survey but had a question about my answer.
My code is SRVY-7X9K."

Support workflow:
1. Export responses from the survey
2. Search for SRVY-7X9K in the Short Code column
3. Find the respondent's specific response
4. Address their question with their data

Example: Internal Survey Tracking

Scenario: HR needs to verify employee participation.

Setup:
- Enable FairMatch codes on employee survey
- Employees complete survey anonymously

Verification:
- Employee receives code SRVY-B4L8
- Employee submits code as proof of completion
- HR can verify code exists in export
- Individual answers remain anonymous

Example: Participant Confirmation

Scenario: Research participant needs proof of completion.

Academic study:
- Participant completes survey
- Receives code SRVY-M9P3
- Notes code for their records

Later:
- Participant needs to confirm participation
- Provides code to research coordinator
- Coordinator verifies code in data

Plan Availability

FairMatch is available on all plans as a basic feature.

Troubleshooting

Issue: FairMatch code is empty

Symptoms: fairmatch_code column is blank.

Solutions:

• Verify FairMatch is enabled in Completion Settings
• Ensure the response was actually completed (not screened out)
• Check that preview mode was not used (preview does not generate codes)

Issue: Code not visible to respondent

Symptoms: Respondent did not see or remember their code.

Solutions:

• Verify "Show FairMatch Code" is enabled
• Check the thank-you page is displaying correctly
• Respondent may have closed page too quickly

Best Practices

• Enable from the start - Add FairMatch to all surveys where you need a reference code
• Explain to respondents - Tell them to save the code for their records
• Include in exports - The fairmatch_code column helps with support lookups
• Use for support - Ask respondents for their code when troubleshooting