> For the complete documentation index, see [llms.txt](https://native-app-co.gitbook.io/product-pelican/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://native-app-co.gitbook.io/product-pelican/getting-started/pelican-brain.md).

# Pelican Brain

The first-run report Product Pelican builds about your store — what it sells, how AI sees it, and prompts tailored to your brand.

Product Pelican researches your store as soon as it is installed. A minute later **Pelican Brain** shows what AI knows about your store, your best sellers and what holds them back, the fixes that matter most, and three AI prompts in your brand's voice to apply with one click.

Open **Pelican Brain** in the app menu, or follow the banner on the Dashboard.

{% hint style="info" %}
**Pelican Brain only reads** your catalogue and public pages. The one thing it can change is your AI prompts, and only when you click **Apply selected**.
{% endhint %}

## While it researches

The Dashboard banner and the Pelican Brain page show which step it is on:

1. Analysing your catalogue
2. Reading your site
3. Ranking your key products
4. Checking your collections
5. Checking how AI sees your store
6. Writing prompt suggestions

This usually takes under a minute. If it stalls, a **Restart research** button appears. If it fails, you see **Research didn't finish** with **Try again**.

## What the report contains

### What AI knows about your store

* **Your catalogue** — what you sell, how many products and collections, your price range, main categories and brands. Large catalogues are sampled, and the page says so.
* **How an AI assistant would describe you** — what an AI shopping assistant can find on your site: categories, notable products, shipping terms and returns policy. Anything it could not find is marked **Not found**.
* **What limits AI here** — the reasons an AI would struggle today, such as no About page, shipping rates not stated, or a menu link to a missing page. A password-protected store is called out, because nothing on it can be read yet.

Pelican Brain finds your About, FAQ, shipping and returns pages through your store's menus. If a page exists but is not linked, add it to a menu and re-run.

{% hint style="warning" %}
**This is a realistic proxy, not a guarantee.** It shows what an AI model makes of your public pages, not what any particular assistant will say.
{% endhint %}

### Your key products

Up to 20 of your best sellers in rank order, each with its [GEO score](/product-pelican/geo-score/geo-score.md) and its gaps: missing category, thin description, missing alt text and so on. Above the grid are the total gaps, how many products have one, and how many bulk fixes would clear them.

Ranking uses Shopify's best-selling order for your online store. No sales figures are shown or stored. Headless and point-of-sale-only stores are ranked from their collections instead.

### Priorities to fix

The same gaps grouped by issue, such as "10 products are missing categories", biggest impact first. **Fix now** on a card opens that issue in the [product audit](/product-pelican/products-and-collections/product-audit.md).

### Suggested prompts

Pelican Brain writes three [AI prompts](/product-pelican/ai-content/ai-prompts.md) tailored to your store:

* **Product description prompt**
* **Collection description prompt**
* **Product FAQ prompt**

Each draft is the standard prompt with a **brand context** block on top: what you sell, who buys from you, your voice, style rules and words to avoid, built from your product copy and site pages. **View full context** shows the wording all three share.

* Click a card to open its draft, and edit it if you like.
* **Preview on a real product** (or collection) shows what the draft would generate, next to what is there today, without saving anything.
* Tick **Apply this prompt** on the ones you want, then click **Apply selected**. Applied prompts take effect immediately.

Applied prompts appear on [AI Prompts](/product-pelican/ai-content/ai-prompts.md) as **Customized**, where you can edit or reset them. A draft that could not be tailored is shown as **Generic — not tailored** and left unticked.

### Likely FAQ topics

The questions shoppers of a store like yours tend to ask. Use them as a checklist when you generate [product](/product-pelican/faq-generation/product-faq.md) and [collection](/product-pelican/faq-generation/collection-faq.md) FAQs.

## Re-running the research

Click **Re-run research** when your catalogue or site has changed. The report is rebuilt, and prompts you have applied are left alone. You can re-run once every ten minutes.

## The Dashboard banner

The Dashboard shows a Pelican Brain banner while the research runs and when it is ready, until you dismiss it or apply a suggested prompt.

## Related pages

* [AI prompts](/product-pelican/ai-content/ai-prompts.md) — where applied prompts live
* [GEO score](/product-pelican/geo-score/geo-score.md) — how the scores on your key products are calculated
* [Product audit](/product-pelican/products-and-collections/product-audit.md) — where **Fix now** takes you