# Tokens

## 🔐 What are tokens ?

Token are pre-generated unique values that can be used by respondents to access the survey. These tokens can be automatically generated using the [token generator](/form-management/security/security-items/tokens/token-generator.md) or you can create or [import](/form-management/security/security-items/tokens/token-generator.md) your own set of token values.

Once a token has been used by the respondent ngSurvey will link that token to the respondent responses to let you track down in the [respondent reports](/form-management/respondents-management.md) the respondents based on the token they used.

As tokens are just text values you can easily distribute them to your respondents using any kind of electronic or non-electronic way from standard mail to phones or emails.

{% hint style="warning" %}
Each token can only be used one time by a respondent.
{% endhint %}

## 🔅 Tokens security properties

* **`Token source variable name`** is the browser querystring variable that holds the token value when you want that the token security item retrieves automatically the token from the browser's querystring. 
* **`Allow access to valid tokens only`** open the survey to respondent who don't have any tokens. If this option is enabled respondent without token will be able to take the survey several times while respondent with a valid token will only be able to submit once their answers.
* **`Hide login screen`** if no valid token has been found dont show to the respondent the user interface to enter the token.

{% hint style="success" %}
This security item can be used as a [key provider](/form-management/security/key-provider-concepts.md). 
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ngsurvey.com/form-management/security/security-items/tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.