Documentation

Personas

AI doesn't give everyone the same answer. Ask which pharmacy to use as a Medicare senior in Syracuse on a fixed budget, and you may get a different list than a parent managing three prescriptions gets. Ask for the best AP automation software as the CFO of a 15-person startup, and you may get a different shortlist, and different warnings, than the controller of a 2,000-person company gets. Personas let you see those differences. A persona is one synthetic person who asks AI about your brand. Add personas to a project and every discovery prompt in it also runs once a day as each of them, so you can compare how AI answers that person with how it answers the same prompt asked with no persona.

What You'll Learn

  • What a persona is, and exactly what we send to AI
  • Where your audience comes from and how to change it
  • How to draft personas from your brand profile or create them by hand
  • How to add personas to a project, and how their runs count against your plan
  • How to read Perspectives: baseline comparisons, thin samples and who AI recommends to each persona
  • How to filter the Recommendations page by persona

What a Persona Is

Each persona is one of two kinds of asker. You choose which under Who's asking in the editor:

  • A person asks for themselves, their household or someone they care for. A Medicare senior choosing a pharmacy, a homeowner after hail damage, a parent with a question about their child's school or a visitor planning a trip to a film festival are all people.
  • Someone at an organization asks on behalf of their work, like a CFO choosing AP automation software or an HR director comparing benefits providers.

Which kinds you see depends on who asks AI about your brand. A pharmacy may have both: patients and caregivers, plus employers buying services for their staff. See Who Asks AI About Your Brand.

A person

FieldWhat it holds
Who they areA short description, like "Medicare senior" or "Caregiver for an older parent". The persona is shown by this description.
Audience segmentThe part of your audience they belong to, like "Medicare prescriptions". It groups results in Perspectives and is never sent.
Where they areA city or region, like "Syracuse, New York".
About themOne sentence in the first person, like "I'm retired and manage my own Medicare prescriptions."
What they already havePlans, products or services they already use, like a Medicare Part D plan.
What matters mostTheir priorities, like predictable prescription costs.
ConstraintsWhat limits their choice, like a fixed monthly budget.

Someone at an organization

PartFields
Who they areTitle, role group (Finance, IT, Operations and so on), seniority, and their role in the decision: economic buyer, champion, technical evaluator, end user or gatekeeper.
Their organizationSegment, organization size, industry and region.
Their situationThe tools they already use, their priorities and their constraints.

Someone at an organization is shown role first, for example "CFO, early-stage startup".

A name is optional for either kind. When you add one, it appears next to the persona for your team only and is never sent to AI.

What we send

We turn the fields into one short first-person paragraph of at most 600 characters and put it in front of the prompt, word for word. For the Medicare senior and the prompt "Which pharmacies in Syracuse accept Medicare Part D plans?", the platform receives:

I'm a Medicare senior in Syracuse, New York. I'm retired and manage my own Medicare prescriptions. I already have a Medicare Part D plan and several maintenance medications. What matters most: coverage under my drug plan; predictable prescription costs; help managing refills. Constraints to keep in mind: fixed monthly medication budget; some prescriptions require ongoing refills. Which pharmacies in Syracuse accept Medicare Part D plans?

For a CFO at a software company and the prompt "What is the best AP automation software for a growing company?", the platform receives:

I'm the CFO at a B2B SaaS company in the United States with about 120 employees. I sign off on the purchase. We use QuickBooks Online and Gusto. My top priorities: close the books in under five days. Constraints to keep in mind: no dedicated AP clerk. What is the best AP automation software for a growing company?

The question itself never changes. Only the asker does, which makes the persona answer a fair comparison with the same prompt asked with no persona.

The editor shows this text live under What we send, with a character count. If you'd rather write it yourself, turn on Write what we send myself: we send your text (up to 600 characters) instead, and the fields still group results in Perspectives. The name, audience segment and role group are never part of what we send; they only change how a persona is shown and grouped.

Who Asks AI About Your Brand

The top of the Personas page shows who asks AI about your brand: one sentence that sums up your audience, and whether that audience is People, Organizations or Both.

Where it comes from

We read three things about the property:

  • What it is: a brand, a category or a person. A category of robot vacuums is asked about by households; a chef is asked about by diners and culinary students.
  • Its brand profile: the Brand Snapshot, including its customer segments.
  • Its tracked prompts: up to 12 of them, so the personas fit the questions you actually track.

A new property gets its audience from the Brand Snapshot. For an older property, the audience is worked out and saved the first time you generate personas. We never assume a business purchase: organization personas only appear when your audience includes organizations.

How to change it

  • People, Organizations or Both: pick a different option next to the summary. It decides whether One organization's team is offered when you generate personas.
  • The summary and segments: click Edit next to the source line to open the brand profile. A sharper profile makes sharper personas.

Changing the audience never changes personas you already have.

Creating Personas

Open Personas in the property sidebar, next to Prompts. Creating, generating and editing personas is free, and you can keep as many as you like. Nothing runs until you add a persona to a project.

Generate them from your brand profile

  1. Click Generate personas on the Personas page.
  2. Choose who to draft:
    • A mix of people (the default): 3 to 5 different people who'd each ask your tracked questions.
    • One person: one person from an audience segment you pick.
    • One organization's team: 3 to 5 people at one organization weighing the same decision, such as who signs, who runs the review and who uses the product every day. Offered only when organizations are part of your audience.
  3. Review the drafts. Each one says why it was drafted. Keep the ones that fit, edit anything, then create them.

You can also start from the Customer segments tile on the Brand Snapshot page: Create personas next to a segment drafts one person from that segment, and the button under the list drafts a mix of people.

Nothing is saved until you create the drafts. Drafts never list your own brand or your tracked competitors among what a persona already has, so the persona doesn't steer answers toward or away from them.

Create one by hand

Click New persona, choose A person or Someone at an organization under Who's asking, and fill in the fields. The What we send preview updates as you type.

Edit a persona

You can change any field at any time. Only a change to the text we send starts a new version. When the persona runs on a project, saving starts the next version from the next daily run, and Spyglasses adds an automatic annotation to each of its projects so trend charts mark the day the wording changed. Earlier answers stay under the earlier version. Changing the name, audience segment or role group doesn't start a new version.

Archive and restore

Archiving a persona stops its daily runs after today. When the persona is on a project, you're asked to confirm first, and the dialog lists the projects it runs on. Its answers so far stay in Perspectives. To bring it back, open Show archived and restore it; its daily runs resume on the same projects.

Personas belong to the property. A location uses its parent's personas.

Adding Personas to a Project

Choose personas in the Ask as personas section when you create a project, or later on the project's Personas tab. The picker groups people by audience segment and organization personas by role, so you can select a whole group in one click.

Once personas are on a project:

  • Every discovery prompt in the project also runs once a day as each persona. Brand-identity and comparison prompts are left out, because a prompt that names you invites an answer about you.
  • Persona runs use the AI platforms your property tracks, except Google AI Overviews, so ChatGPT and Gemini by default, plus any add-on platforms your property has. AI Overviews answers a search, not a person, so a persona version would repeat the regular run.
  • The first answers arrive today. Adding a persona starts its first run right away. After that it runs with your daily tracking.
  • Persona runs use the brand-wide run only. They aren't repeated for each location.

Persona answers feed Perspectives and the persona filter on Recommendations. Goals and citations come from the answers asked with no persona.

How Persona Runs Are Counted

Each prompt asked as one persona is one tracked prompt from your plan's allowance, the same way a location is. A project with 12 discovery prompts and 2 personas adds 24 runs a day. When a persona already asks a prompt through another project, those runs aren't counted twice, and the picker names the other project.

Before you save, the Daily runs panel in the picker shows the change in one line, for example:

+24 runs/day: 12 included, 12 billed, about 12 credits per 30 days

A meter under it shows how many tracked prompts you'll use after saving against the number your plan includes.

  • Within your plan: the runs are included and you can save straight away.
  • Over your plan: the panel says how far over you'll go and what it costs. Each run a day beyond your plan uses 1 credit every 30 days (1 credit per 30 daily runs, prepaid). Tick the confirmation checkbox to save.
  • Unlimited plans: every run is included.

Removing a persona from a project stops its runs there after today. Its answers so far stay in Perspectives.

Your Headline Metrics Stay the Same

Dashboard numbers count only answers asked with no persona. We call these answers the baseline. Share of voice, mentions, consistency, citations and the Recommendations page (with no persona selected) all read the baseline, so adding or removing personas never moves them. The coverage and data accuracy figures on a project's Prompts tab cover the baseline runs too.

Perspectives

Perspectives shows how AI answers your prompts when a specific persona asks, compared with the baseline. It's a dashboard page next to Recommendations. Open it with Open Perspectives on a project's Personas tab, from a persona's card on the Personas page, or with Compare every persona with the baseline on the Recommendations page when a persona filter is on.

Same question, different asker

Each row is one persona, or a group of personas, compared with the baseline over the same prompts and platforms in the same window. If a persona runs on 3 of your 50 prompts, its baseline is those same 3 prompts asked with no persona. Google AI Overviews is left out on both sides.

Filters and controls

ControlWhat it does
Window7, 30 or 90 days. The default is 30, because persona samples fill up more slowly than your baseline.
ProjectNarrows to one project's prompts and personas.
PlatformNarrows to one AI platform.
Group byPersona, Audience segment, Role, Organization size or Seniority, offering only the ones your personas have. Role, organization size and seniority apply to organization personas. A group pools the answers of every persona that shares the value, for example everyone in the Medicare prescriptions segment. Grouping needs two or more personas.
ShowTop-choice rate (the default), Cautioned rate or Mention rate. Mention rate counts an answer once if it names the brand in any way: top choice, one of many, generic mention or cautioned against.

The categories behind these rates are explained on Recommendations.

What the page shows

  • The biggest difference. The page leads with the largest clear difference for your brand in one sentence, with the persona's rate, the baseline and the difference. It adds the main reason AI gives when it cautions, or the phrase AI most often uses when it calls you best for this persona, and links to the answers behind it. When no persona differs clearly from the baseline, the page says so rather than promoting noise.
  • How AI answers each persona about your brand. One row per persona. The dot is the persona's rate, the dark tick is the baseline over the same prompts, and the whisker is the persona's 90% interval. Rows are sorted by difference, and color appears only where the difference is clear. Pick a row to see who AI recommends to that persona.
  • Who AI recommends to the persona. Share of recommendation among the selected persona's answers: each brand's recommendations (top choice or one of many) as a share of every brand's recommendations, untracked brands included, next to the same brand's baseline share. Your brand is marked You and brands you don't track are marked Not tracked. Choose Baseline (no persona) to see the market with no persona.
  • Compare every brand. Closed by default. The chosen rate for your brand, your tracked competitors and the most-named untracked brands, as each persona. Differences show as an arrow and points, with no green or red, because a competitor's gain isn't good news for you.

Reading a baseline comparison

A difference is the persona's rate minus the baseline rate over the same prompts, in percentage points. If AI names you its top choice in 12% of the answers a Medicare senior gets and in 31% of the baseline answers for the same prompts, the difference is 19 points lower. Points are not percent: a move from 20% to 30% is 10 points.

Every difference comes with a 90% interval. A difference is clear only when its whole interval sits on one side of zero. Anything else could be noise, and the page draws it in gray.

Thin samples

A persona with fewer than 30 answers in the window is an early read. The row is grayed out, shows how many answers it has (n), and is never marked clear. At that size one answer moves a rate by several points. Wait for a few more days of daily runs, or widen the window to 90 days, before you read it.

As a guide, a persona on 5 prompts across two platforms gets about 10 answers a day, so it passes 30 answers in about three days.

What a persona already has

Answers often restate what the asker says they already have. When a persona already has a Medicare Part D plan, or uses QuickBooks Online at work, an answer may name it without recommending it. The AI judge rates something the persona already has as a generic mention unless the answer recommends it for the question, and Perspectives marks those brands Already has, so a restated plan or tool doesn't read as a recommendation.

Before the first answers

  • First answers today: a persona added to a project today has its first run under way. The page fills in as the answers come back, next to the baseline for the same prompts.
  • No personas yet: the page explains what Perspectives compares and links to the Personas page, where you can generate personas and then add them to a project.

In the client portal, Perspectives is read-only: clients can read every comparison and open the answers behind it, and the links to manage personas aren't shown.

Filter Recommendations by Persona

The Recommendations page and its answers page have a Persona filter. It groups people by audience segment and organization personas by role, the same way as the Personas page. Choose a persona to narrow the rates, shares, cautions and answers to the answers asked as that persona. Links from Perspectives land here already filtered to that persona or group.

While a persona is selected, a line above the page says whose answers you're reading and links back to Perspectives. Google AI Overviews isn't offered as a platform, because persona runs skip it. With the filter on None (baseline), the page shows the baseline, exactly as it does without personas.

Opening a persona answer shows the persona and a What we sent section with the full text the platform received: the persona's paragraph followed by the unchanged prompt.

Best Practices

Start with a mix of people

A mix shows how AI treats different people asking the same questions, like a Medicare senior, a caregiver and a parent asking about the same pharmacy. When organizations are part of your audience, draft one organization's team for your main decision too. Differences between the person who signs and the person who runs the review are often the first useful finding.

Keep each persona specific and true

A real place, what the person actually has today and what they actually need produce the answers that person actually gets. The same goes for organization personas: real titles, a real organization size and the tools that segment really uses. Vague personas get vague answers that look like the baseline.

Give personas enough prompts

A persona on a handful of prompts takes longer to pass 30 answers. Add personas to a project whose discovery prompts cover the questions that person asks.

Read the cautions by persona

When Perspectives shows AI cautions a persona against you more often than the baseline, filter Recommendations by that persona and open Why AI cautions against you. The reason and audience AI gives are the claims to answer for that persona.

Edit wording sparingly

Each change to what we send starts a new version and marks the charts. Settle the wording early, then leave it alone so the trend stays comparable.

FAQ

Do personas change my dashboard numbers? No. Headline metrics count only answers asked with no persona, so adding, editing or removing personas never moves them.

Does creating personas cost anything? No. Creating, generating and editing personas is free. Only persona runs on a project count as tracked prompts.

Can one property have both people and organization personas? Yes. When your audience is set to Both, you can draft a mix of people and one organization's team, and both show side by side in Perspectives.

What happened to the personas I made before? They're personas for someone at an organization. What we send for them hasn't changed, so they keep their version and their trends stay comparable.

Why don't persona runs include Google AI Overviews? AI Overviews answers a search query, not a person, so a persona version would repeat the regular run. Perspectives leaves it out of both sides of the comparison.

Is the persona's name sent to AI? No. Only the paragraph under What we send goes in front of the prompt. The name, audience segment and role group stay in Spyglasses.

Why is a persona grayed out in Perspectives? It has fewer than 30 answers in the window. Wait a few more days, or switch the window to 90 days.

What happens when I archive a persona? Its daily runs stop after today, and its answers so far stay in Perspectives. Restore it any time and its runs resume on the same projects.

Explore personas with an AI assistant (MCP)

If you've connected the Spyglasses MCP server, list_personas returns a property's personas with the exact text we send for each, and get_persona_lens returns the same baseline comparison as Perspectives. See MCP → Account data.

  • Recommendations: The categories behind every Perspectives rate, and the persona filter
  • Projects: Add personas to a project so its prompts run as each persona
  • Brand Snapshot: The brand profile and customer segments personas are drafted from
  • Prompts: Author the discovery prompts personas ask
  • Annotations: The chart markers written when personas are added, edited or archived
  • Locations: How location runs are counted, the same way as persona runs
How-to guides for setting up Spyglasses to track your AI traffic