# Panelist Mapping

## 🔃 What is panelist mapping ?

the [panelist ](/panels/panelists.md)mapping allows you to define how the [panel security item](/form-management/security/security-items/panel-security.md) will look up the panelist to load from the [panel](/panels.md) across the panels that have access to your [panel security item](/form-management/security/security-items/panel-security.md). 

Out of the box the panel column and value that will be used to look up the panelist in your panel is the  panelist id column. The panellist id is a uniquely generated value that identify the panelist in the panel.

![](/files/-MC3grk0nmpYoJ2HAiA1)

When the respondent enters its panelist id before taking the survey ngSurvey will look up the panelist based on that id to let you re-use its data  in your survey.

There are times though when you might need to use another value than the panelist id to let the respondent enter your survey and look up the panelist data. Using the **panelist id source type** on your [panel properties](/panels/untitled-4.md) page you may choose a different [panelist attribute](/panels/untitled.md) that will be used by the [panel security item](/form-management/security/security-items/panel-security.md) to lookup the panelist.  

![](/files/-MC3g-FQiP3YFu8XSaF1)

## ✒️ Mapping Example

If you have created a panel like the following contact panel 

![](/files/-MC5Ta9Id6f1gModDbHu)

You could configure the panel use the panel's email as a lookup column and ask the survey respondent its email instead of the panelist id.

![](/files/-MC5TojGBOUFCcfljANY)

Your respondents will now be asked for their email before entering the survey.

![](/files/-MC5WYHqDTwDDijILllF)

{% hint style="info" %}
You may replace the default [panel security](/form-management/security/security-items/panel-security.md) label text "Please enter your panelist id" using the survey local [resources](/form-management/form-designer/multi-language-forms/local-resources.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/panel-security/panelist-mapping.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.