> ## Documentation Index
> Fetch the complete documentation index at: https://developers.perform.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Personas

> Personas are buyer segments that add persona-specific prompts to AI Commerce Visibility and let you view every insight through one audience.

**Available to all AI Commerce Visibility customers.**

## Summary

Personas add an audience lens to AI Commerce Visibility. You define the buyer segments that matter to your business, such as a value-driven parent or a premium enthusiast, link them to your product categories per market, and AI Commerce Visibility generates prompts phrased the way that audience asks. Persona View then shows every chart, ranking and table through one persona's prompts.

## Who it’s for

Marketing and e-commerce teams who segment their market and want to know whether AI assistants recommend them to each segment. A budget-conscious first-time buyer and a premium enthusiast ask very different questions, and a brand can be recommended often to one while being absent for the other.

## Key benefits

* **A starter set is generated for you.** When your account is activated, AI Commerce Visibility creates draft personas from your company name, brand attributes and product attributes. You review, edit or add before anything runs.
* **Personas add to your data, they never replace it.** Persona prompts run alongside the generic prompt set, so your existing visibility data is unchanged.
* **Prompts are phrased the way the audience asks.** For each linked persona, prompts are reshaped around the persona's description and written as real buyer questions.
* **One activation, every category and market.** Activating a persona links it to all categories in all markets, and you then remove it from markets where it is not relevant.
* **Every insight tab gets the lens.** Persona View filters the Dashboard, Brand, Product, Merchant, Trust and Sources tabs to one persona.

## How it works

### Persona fields and limits

| Field | Rule |
| - | - |
| Name | Required. Up to 100 characters. Unique within the account, ignoring case. |
| Description | Required. Up to 1,500 characters. Used to shape the persona's prompts, so describe how this audience shops and what it cares about. |

### Lifecycle

A persona moves through Draft, Active and Deactivated or Deleted.

| Status | What it means |
| - | - |
| Draft | Created by the system or by you, not yet activated. Does not link to categories or generate prompts. Can be edited or deleted. |
| Active | Linked to categories and markets, generating persona-specific prompts. Cannot be edited. |
| Deactivated | No longer generating prompts. |
| Deleted | Removed permanently. Only possible in Draft. |

Editing is only possible in Draft. Deleting is permanent and only possible in Draft. Personas are managed one at a time; bulk activate, deactivate and delete are not available, and personas cannot be cloned or shared across accounts.

### Generated starter personas

Once brand and product discovery is complete for your account, AI Commerce Visibility creates a starter set of personas in Draft from your company name, brand attributes and product attributes. The number and content vary per account; there is no fixed template.

### Linking and markets

Activating a persona links it to every product category in every market. You can then remove the persona from individual markets while keeping it active elsewhere, for instance when a segment exists in one country but not another.

### Prompt generation and execution

For each linked persona and category, AI Commerce Visibility generates persona-specific prompts next to the generic set, conditioning the questions on the persona's description and phrasing them as a real buyer would. Persona prompts are picked up on the next scheduled run, together with the generic prompts, across the AI assistants you track. Activation does not trigger an immediate run. Only future runs generate persona prompts; historical data is not reprocessed.

### Persona View

Persona View is a filter on every Insights tab. Selecting a persona re-renders all charts, rankings and tables from that persona's prompts. One persona is shown at a time; side-by-side comparison of two personas is not available. The Persona filter also applies to the Sources and Citations tabs and to data exports, and content generation can be narrowed by persona.

## Set up in the portal

Go to **AI Commerce Visibility** > **Configuration** > **Personas**.

1. Review the draft personas generated for your account. Edit the name or description of any you want to keep, or add your own with a name and description.
2. Activate each persona you want to track. It is linked to every category in every market.
3. To tailor a persona, remove it from the markets where it is not relevant.
4. Wait for the next scheduled run. Persona prompts run together with the generic prompts.
5. On any Insights tab, select the persona in Persona View to see the results through that audience.

## FAQ

### Can I compare two personas side by side?

Not currently. Persona View shows one persona at a time. Switch personas in the filter to compare.

### Can I copy a persona or share it with another account?

No. Cloning and sharing across accounts are not available.

### Can I activate or delete several personas at once?

No. Personas are managed one at a time.

### If I activate a persona today, will it reprocess my past data?

No. Only future scheduled runs generate persona-specific prompts. Earlier periods keep the generic data only.

### Does activating a persona change my existing data?

No. Persona prompts are added on top of the generic prompt set. Your generic Visibility, Ranking and Sentiment are unchanged, and the persona results appear when you select the persona in Persona View.

### Can I edit an active persona?

No. Editing is only possible in Draft. Deactivate the persona and create a new one with the changed description.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| Persona View shows no data for a new persona | Persona prompts run on the next scheduled run, not on activation | Wait for the next run. The cadence is shown under **Settings**. |
| A persona cannot be edited | The persona is Active | Editing is Draft-only. Deactivate it and create a new persona with the changes. |
| A persona cannot be deleted | The persona is not in Draft | Deletion is Draft-only. Deactivate the persona instead. |
| Saving a persona fails on the name | The name is already used, in any letter case | Choose a different name. Names are unique within the account, ignoring case. |
| A persona appears in a market where it is not relevant | Activation links a persona to all markets | Remove the persona from that market under its configuration. |

## Related

* [Prompts](https://developers.perform.ai/products/ai-commerce-visibility/prompts.md)
* [Product Categories](https://developers.perform.ai/products/ai-commerce-visibility/product-categories.md)
* [Brand Visibility](https://developers.perform.ai/products/ai-commerce-visibility/brand-visibility.md)
* [AI Commerce Visibility overview](https://developers.perform.ai/products/ai-commerce-visibility/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.