# Population library

Find populations on the Populations page with vertical chips and favourites, review their distribution charts and linked studies, and download the persona list to Excel.

The **Populations** page is the library of every population you have created. A population is a group of synthetic consumers (personas) that a study runs on. You create it once, it is saved, and you can reuse it in later studies. Each population belongs to a single vertical: General Research, Fashion or Ad Testing.

The library has no button for creating a population. You create a new population in the **New Research** wizard while you set up a study. For details, see [Creating a population](/en/docs/populations/creating-a-population).

## Opening the library

In the sidebar, click **LIBRARY** › **Populations**. If you don't have any populations yet, the page shows the message "No populations yet".

Which populations you see depends on your account type:

| Account | Populations you see |
| --- | --- |
| Personal account | Only the ones you created |
| Organisation member | Only the ones you created |
| Organisation admin | Every population in the organisation |

Only the user who created a population and the organisation admin can rename or delete it. Roles are described in [Account and organisation](/en/docs/account/account-and-organisation).

## Population cards

Cards are sorted by creation date, with the newest population at the top. The library has no option to change the sort order. Each page holds 20 cards; if there are more populations, page buttons and a counter such as "1-20 / 45 population" appear at the bottom of the page.

| On the card | Meaning |
| --- | --- |
| Name | The name given to the population |
| Vertical badge | **General Research**, **Fashion** or **Ad Testing** |
| Product or brand | Shown if it was entered when the population was created |
| "N persons" | Number of personas in the population |
| Date | Day and time of creation |
| **LATEST** | The newest population; shown only when **All** is selected, no search is active and you are on the first page |

Each card also has a favourite star and a three-dot menu (**Rename**, **Delete**). Click anywhere else on the card to open the population's detail page.

## Search and filters

The search box looks in the population's name, product and brand and, for General Research populations, also in the model. The list updates by itself when you stop typing.

Search ignores differences in letter case and in Turkish-specific characters: searching for "kadin" also finds populations containing "Kadın". If you type several words, only populations that contain all of them are listed. Vertical names such as "fashion", "ad test" and "general" also work as search terms.

The calendar menu next to the search box filters the list by creation date: **All time**, **Last 7 days**, **Last 30 days** or **Custom range**. In the **Custom range** dialog, enter the **From** and **To** dates and click **Apply**.

The chips below it narrow the list: **All**, **General Research**, **Fashion**, **Ad Testing** and **Favorites**. The number on each chip is how many populations remain after the search and date filter; vertical chips with zero results are hidden. If no results remain, click **Clear search and filters**.

## Favourites

To add a population to your favourites, click the star on its card or next to its name on the detail page; click the star again to remove it from your favourites. The **Favorites** chip shows only starred populations. The population selection screen uses the same favourites list when you set up a new study.

> [!NOTE]
> Favourites are stored in your browser, not in your account. They don't appear in another browser or on another device, and they aren't shared with your teammates.

## Reviewing a population

Click a card to open the **Population Detail** page. At the top of the page are the vertical label, the population's name and the favourite star; for General Research populations, the product, brand and model also appear under the name. To return to the list, use the **Back to populations** link.

Below the header are these summary cards:

| Card | What it shows |
| --- | --- |
| **Person Count** | Number of personas in the population |
| **Created** | Date and time of creation |
| **Segmentation File** | The segmentation data used to split the population into market segments; **Not Specified** if none was used |
| **Distribution method** | Ad Testing only, in place of the segmentation card: **Archetype-based distribution** |
| **Linked experiments** | Number of studies that use this population; click it to open the list of studies |

### Demographic charts

The page first shows four charts: **Gender Distribution**, **Age Distribution**, **Market Segment Distribution** and **SES Distribution**. Use the button below these charts to open the others as well: **Education Distribution**, **Work Status Distribution**, **Location Distribution**, **Income Level**, **Marital Status Distribution** and **Household Size Distribution**. A chart with no data isn't shown.

Each chart shows the name of every category and its percentage rounded to one decimal place; most also give a count in the form "46 of 200 people". Categories are sorted from largest to smallest, except in **Age Distribution**, which lists the age groups from youngest to oldest.

- **Market Segment Distribution**: In General Research, percentages are calculated only over personas that have a segment assigned; if no persona has a segment, the chart doesn't appear. In Ad Testing, if there are no market segments, this chart shows viewer archetypes instead. How market segments are added to a population is described in [Segmentation](/en/docs/results/segmentation).
- **Location Distribution**: Shows the 10 cities with the most personas.
- Fashion and Ad Testing populations have no **Marital Status Distribution** or **Household Size Distribution**.
- There's no chart for lifestyle; this information is in the Excel file.
- Personas with a missing value are grouped on the chart into a category called "Unknown".

### Linked studies

Click the **Linked experiments** card to open the **Linked experiments** panel. The panel lists every study that uses the population, with its name, method, status and creation date. The status labels are **Draft**, **Generating** (the study is running), **Completed** and **Failed**.

Clicking a row opens the report for a completed study, and the setup or progress screen for any other study.

## Renaming

1. In the **Populations** list, open the three-dot menu on the card.
2. Choose **Rename**.
3. Type the new name in the **Population name** field. The name can't be empty and can be at most 255 characters long.
4. Click **Save**.

You can only rename a population from its card in the list; the detail page doesn't offer this option. Because search also looks in population names, choose names that describe the target audience.

## Deleting

1. Choose **Delete** from the three-dot menu on the card.
2. In the **Are you sure?** dialog, check the name of the population that will be deleted.
3. Click **Delete**.

> [!WARNING]
> Deleting can't be undone; the app has no option to restore a deleted population.

How deleting affects studies depends on the population's vertical:

- **General Research**: When you create a population with **Create New Population** in the wizard, the study you are setting up at the time is kept in the same record as the population. Deleting the population also deletes that study, and its report disappears from the **Reports** list. Studies that later use the same population through **Select Existing Population** are saved separately and aren't deleted.
- **Fashion** and **Ad Testing**: Studies are saved separately from the population; deleting the population doesn't delete them.

Before you delete a population, open the **Linked experiments** panel to check which studies use it.

## Exporting to Excel

1. Open the population.
2. Click **Download Excel** to the right of the header.

While the file is being prepared, the button reads **Preparing Excel…**; when the download starts, it briefly reads **Download ready**. For Fashion and Ad Testing populations, the button appears only once generation is complete.

The file name ends in "_Population.xlsx". The file has a single worksheet called "population", and each row is one persona. Column headers are in English and values are in Turkish (e.g. "Kadın" for female).

| Column | Contents |
| --- | --- |
| Persona_ID | The persona's record number |
| Name | First name and surname |
| Age | Age group (18-24, 25-34, 35-44, 45-54, 55-64, 65+) |
| Gender | Gender |
| City | City |
| Education | Education |
| Income Group | Income group (A1–E2) |
| SES | Socio-economic status (SES) class (A, B, C1, C2, D, E) |
| SES_Score | SES score |
| Market Segment | Market segment |
| Marital Status | Marital status |
| Work Status | Work status |
| Lifestyle | Lifestyle |
| PVC, QBO, DEA, NOV, HED, POP | Behavioural tendency scores (Fashion and Ad Testing only) |

In Fashion and Ad Testing files, the last six columns are the persona's behavioural tendencies: PVC is the **Price-Value Consciousness** score, QBO **Quality-Brand Orientation**, DEA **Deal Proneness**, NOV **Novelty Seeking**, HED **Shopping Hedonism** and POP **Spending Tendency**. For what these scores mean, see [Persona profiles](/en/docs/populations/persona-profiles).

The file doesn't include persona narratives, custom features or personality scores. For per-persona results, use the Excel file you download from the study's report. For details, see [Exporting and downloading](/en/docs/results/exporting).

## Using a population in a new study

When you reuse a population, the study runs with the same personas and the same number of personas; the personas aren't generated again. If you need a different target audience or a different number of personas, create a new population.

Populations aren't shared across verticals: you can't select a Fashion population in General Research. For the other steps of the wizard, see [Starting a new study](/en/docs/research/new-study); to run a saved population directly with a saved survey, see [Quick Research](/en/docs/research/quick-research).

> [!TIP]
> If you plan to compare the results of two studies, run both on the same population. When the personas stay the same, any difference between the results doesn't come from the population.

### In General Research

1. In the sidebar, click **New Research**.
2. Choose the **General Research** card.
3. Choose a method card.
4. On the **Choose Population Mode** screen, click the **Select Existing Population** card.
5. Find the population in the list that opens and select its card. To search, you can use the **Search populations...** box, the sort menu (**Recently created**, **Recently used**, **Person count**) and the **All** / **Favorites** filter.
6. Optionally, click **View details**. The **Population detail** panel shows the number of personas, the creation date, the age, gender and SES distributions and any custom features. You can also select the population from here with **Select this population**.
7. Click **Continue with selected population**. The study is created and the survey design step opens.

In General Research, your balance must hold at least 500 credits for the study to be created; this check also applies when you select an existing population. No credits are deducted at this step; credits are spent while the study runs. For details, see [Credits](/en/docs/account/credits).

### In Fashion and Ad Testing

1. On the **Choose a population** screen, click the **Use existing population** card.
2. Select the population from the list.
3. Click **Continue with selected population**.

The list includes only populations that were created in the same vertical, are complete and are ready for the method you chose. If there's no suitable population, the card reads "No populations yet — create one first".

## Population statuses

General Research populations have no status label in the library. A population appears in the list once its personas have been created; it isn't listed while generation is in progress or if generation fails. You can follow generation through the badge on the survey design step: **Generating Personas...**, **Personas Created** or **Generation Failed**.

Fashion and Ad Testing populations appear in the list as soon as generation starts, but the card has no status badge. To see the status, open the population:

| Status | On the detail page | What you can do |
| --- | --- | --- |
| Queued or generating | **Population generating…** card; the page refreshes itself every 3 seconds | Wait; the charts and **Download Excel** don't appear yet |
| Completed | Demographic charts and **Download Excel** | Download the file; use the population in new studies if it's ready for the method you chose |
| Failed | An error message in a red card | There's no retry button; create a new population |

On the survey design step, the same status appears as the badge **Popülasyon oluşturuluyor** (Creating population), **Popülasyon hazır** (Population ready) or **Popülasyon oluşturulamadı** (Population could not be created). The population must be ready before you can start the study.

## Related pages

- [Creating a population](/en/docs/populations/creating-a-population)
- [Persona profiles](/en/docs/populations/persona-profiles)
- [Starting a new study](/en/docs/research/new-study)
- [Exporting and downloading](/en/docs/results/exporting)
- [Account and organisation](/en/docs/account/account-and-organisation)