> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/reach-participants/people-and-contacts.md).

# People and contacts

Import your contacts into People, map their columns, keep phone numbers private, and add people to a study.

**People** (in the left navigation) is your organisation's contact list. Everyone you import, and everyone who takes part in one of your studies, has a profile here. From a study you add people with **Add People** on the **Share** tab, then invite them with a broadcast.

{% hint style="info" %}
**In short:** import a CSV, XLSX or XLS file, match your columns to Yazi's fields, and every extra column becomes a custom field you can use in broadcast messages and see in your results. Phone numbers must include the country code. Numbers can be hidden from your team behind participant IDs.
{% endhint %}

## What a person record holds

**Fixed fields:** full name, first name, last name, gender, age, date of birth, language and city.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FaJIE4n2J327uYQfRj5Ja%2Ffs-people.webp?alt=media&amp;token=e27cf307-f6a8-4ee2-902e-db351ee28383" alt="The People page: everyone added by import or by taking part, with their participant ID, language, studies started and completed, and source. Show phone numbers reveals numbers where you are allowed to see them."><figcaption></figcaption></figure>

**Custom fields:** any other column in your file (for example customer ID, region, segment, store, product bought). These are saved on the person and come through as extra columns in your study data.

**Study history:** open a person to see their details and their **WhatsApp history**, the full conversation across every study they were in, including invites and reminders. Very active people show their most recent 200 studies, with a note saying how many are hidden.

## Import contacts

{% stepper %}
{% step %}

### Prepare your file

Use CSV, XLSX or XLS with column headings in the first row and one person per row. Include a phone number column. Write numbers in international format with the country code, for example `27821234567` or `+447700900123`. Any column separator works (comma, semicolon, tab or pipe).
{% endstep %}

{% step %}

### Upload

On **People**, start an import and drop in your file. If the file type is not supported, the screen says so and lists the types to use.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FbfJRVf6vdXslKiHnigzc%2Fpeople-import.webp?alt=media&amp;token=0a2427bc-5b54-42f2-82cc-cf9161a7f50b" alt="Import people, step 1 of 2: upload a CSV or Excel file"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Match your columns

Yazi matches the headings it recognises (for example Mobile, Phone, First name) and shows every column with a sample value and where it will go. Re-point anything that is wrong. A field that another column already uses is greyed out. Columns you leave unmatched become custom fields.
{% endstep %}

{% step %}

### Fix numbers without a country code

If a number is written the local way (for example `0712345678`), Yazi does not guess the country. It flags those numbers and asks you to pick the country. This stops a Kenyan number being sent to a South African stranger, for example.
{% endstep %}

{% step %}

### Import

The people are added to your organisation. Custom field columns are hidden on the People table by default; switch them on with the **Columns** control.
{% endstep %}
{% endstepper %}

## Add people to a study

On the study's **Share** tab, click **Add People**. The window offers suggested audiences, importing a file, browsing your **People** pool, or reusing the participants of a past study.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FoMm6gq0OpriusNFTbwjz%2Ffs-add-people.webp?alt=media&amp;token=c23dcbb7-69bd-405e-b8f3-c4e7349f5819" alt="Add people to a study: suggested audiences from your People pool, or add people manually by typing numbers, importing a file, browsing the pool or reusing a past study"><figcaption></figcaption></figure>

Adding someone to a study does not message them. They show as ready to invite until you send a broadcast. See [Send a broadcast](https://docs.askyazi.com/reach-participants/send-a-broadcast.md).

On a multi-activity study you can also invite people to a single activity, and use **Push**, **Set activity**, **Hold** and **Resume** on a participant to control which activity they get next. See [Multi-activity studies](https://docs.askyazi.com/study-types/multi-activity-studies.md).

## Phone number privacy

Your organisation can hide participants' phone numbers from everyone in your team. With privacy on, the phone column becomes **Participant ID** and screens, exports and Send History show the ID instead of the number. Changing the setting and viewing numbers are both recorded in the audit log.

Separately, a study can have **Privacy Protection** switched on (**Build > Study configuration > Privacy & screening**). On a protected study participants appear as "Respondent #..." on every screen, including the Media Library and takeover chat. See [Participant privacy](https://docs.askyazi.com/security-and-privacy/participant-privacy.md).

## WhatsApp usernames and hidden numbers

WhatsApp now lets people hide their phone number behind a username. When someone like this messages your study, Meta gives Yazi an ID for them instead of a number. They can start studies and receive replies normally.

Things to know:

* You cannot import or broadcast to a username. They can only join through a link or by messaging your number.
* If the same person also appears in People with their phone number, Yazi does not yet link the two records.

## Using People as a panel

Over time People becomes your own panel. Everyone who has taken part is there with the answers you collected, so you can find a group (for example everyone in one city) and invite them to a new study. Only invite people who agreed to be contacted again.

## Limits and things to know

* You can show and hide custom field columns, but you cannot yet sort or filter the People table by a custom field.
* You cannot choose to leave a column out of an import. Unmatched columns always become custom fields (hidden by default).
* A number must be a WhatsApp number. Yazi cannot check in advance whether a number is on WhatsApp; you find out when the broadcast reports it as not registered. See [Send history and statuses](https://docs.askyazi.com/reach-participants/send-history-and-statuses.md).
* Removing someone from a study clears their answers in that study but keeps them in People. See [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md).

## Related

* [Send a broadcast](https://docs.askyazi.com/reach-participants/send-a-broadcast.md)
* [Broadcast templates](https://docs.askyazi.com/reach-participants/broadcast-templates.md)
* [Data enrichment](https://docs.askyazi.com/integrations-and-api/data-enrichment.md)
* [Participant privacy](https://docs.askyazi.com/security-and-privacy/participant-privacy.md)
