Installation & setup

Install Product Pelican, run your first audit, and add the optional storefront and admin blocks.

Product Pelican installs like any Shopify app. There is no account to create, no API key to paste, and no theme change required to start using it — the storefront block is only needed if you want to publish product FAQs.

Install the app

1. Install Product Pelican from the Shopify App Store.

2. Approve the permissions when Shopify asks. The app needs to read and write products, collections, metafields and metaobjects — that is what lets it fix the issues it finds.

3. You land on the Dashboard. There is no setup wizard; the app starts reading your catalogue immediately.

📸 Screenshot needed — the Dashboard on first load, showing the KPI cards and the "products that need action" list.

You start on the Free plan, which covers up to 50 products. Nothing is charged and no trial clock is running — see Plans & billing.

Your first audit

The first time you open Products, Product Pelican reads your active products from Shopify and checks each one. Large catalogues load in the background: the page becomes usable on the first batch and fills in as the rest arrives, with a progress bar showing how far along it is.

Results are cached, so the next visit paints instantly instead of re-reading your whole catalogue. Add ?refresh=1 to the URL, or use the refresh control on the page, to force a fresh read.

Only active products are audited. Drafts and archived products are skipped by default. You can widen the status filter on the audit page if you need to include them.

Optional: publish FAQs to your storefront

If you plan to use Product FAQ, you need to add one block to your theme so the FAQs actually render on the product page.

1. In Shopify admin go to Online Store → Themes → Customize.

2. Open a product template.

3. Add block → under Apps, choose Product FAQs.

4. Drag it to where you want the FAQs to appear — usually below the product description.

5. Save.

The block has its own settings for heading text, styling, accordion behaviour and structured data. They are covered in Product FAQ.

📸 Screenshot needed — the theme editor with the Product FAQs app block added below the product description, block settings panel open.

Without this block, FAQs stay invisible to shoppers. They are still saved on your products and still readable by anything that queries your Shopify data, but nothing renders on the page until the block is added.

Optional: add the admin blocks

Two small extensions put Product Pelican information directly on the Shopify product page. Both are optional and both need pinning once.

GEO score trend

Shows a product's current GEO score, how it has moved over the last 7 days, and a small history chart — without leaving the Shopify product page.

1. Open any product in Shopify admin.

2. In the right-hand column, click Add block (or the + in the sidebar).

3. Choose GEO score trend.

4. Pin it so it appears on every product.

📸 Screenshot needed — the GEO score trend block pinned on a Shopify product page, showing the score, the 7-day delta and the history chart.

Trend data comes from a nightly snapshot, so a brand-new store will see the chart fill in over the following days. See GEO score.

Enrich with Product Pelican

Adds an Enrich with Product Pelican entry under More actions on the product page. It shows the product's description length and latest GEO score, and jumps you straight to that product's Descriptions tab inside Product Pelican with the product already selected.

📸 Screenshot needed — the "More actions" menu on a Shopify product page with "Enrich with Product Pelican" visible, and the modal it opens.

Product FAQ block

Lets you read and edit a product's FAQs from the Shopify product page rather than from the app. Added the same way as the GEO score trend block.

What Product Pelican writes to your store

Everything Product Pelican produces is stored in your own Shopify data, not in the app. If you uninstall, your content stays.

What	Where it lives
Descriptions, titles, SEO fields, alt text	The native Shopify product fields
Category attributes	The product's category metafields
FAQ entries	faq_item metaobjects, linked from each product
GEO score history	A metafield on each product
Stitched product links	The metafield you nominate on each stitching rule

Next steps

• Quickstart — fix your first products.

• Product audit — what each check means.

• AI prompts — make the AI write in your brand voice before you generate in bulk.