For the complete documentation index, see llms.txt. This page is also available as Markdown.

Product FAQ

Add questions and answers to your product pages, generate them with AI, and publish them with structured data.

Product FAQs answer the questions shoppers actually ask — sizing, washing, shipping, compatibility — directly on the product page. They also give AI systems something concrete to quote: a question-and-answer pair is the format those systems most readily surface.

📸 Screenshot needed — the Product FAQ page: product list on the left, FAQ editor in the middle, AI suggestions panel on the right.

How FAQs are stored

Each FAQ is saved as a Shopify metaobject, and each product holds an ordered list of references to them.

This matters for two reasons:

  • The data is yours. FAQs live in your Shopify store, not in Product Pelican. They survive uninstalling the app.

  • One FAQ can be shared across many products. "Do you ship internationally?" can be written once and attached to your entire catalogue. Edit it once and it updates everywhere.

  • The same entry works on collections too. Product and collection FAQs share one library — see Collection FAQ.

The first time you open the page, Product Pelican sets up the metaobject definition and the product metafield it needs. This happens automatically.

Adding FAQs

Open Product FAQ and stay on the Products tab (the Collections tab does the same job for collection pages). Pick a product from the list on the left, then:

  • Add a blank FAQ and type the question and answer yourself.

  • Generate with AI — see below.

  • Connect an existing FAQ — attach an FAQ already written elsewhere. The picker shows how many products and collections each one is currently used on.

Drag FAQ entries to reorder them. The order you set is the order they render on the storefront.

Editing a shared FAQ

If you edit an FAQ that is attached to more than one product, you'll be asked what you meant:

  • Update everywhere — changes it on every product using it.

  • Edit this one only — makes a separate copy for this product, leaving the others untouched.

📸 Screenshot needed — the shared-FAQ modal asking whether to update everywhere or edit this product only.

Generating FAQs with AI

Click the AI button in the editor. Product Pelican reads the product — its title, type, description and any metafields you've nominated as context — and drafts a set of question-and-answer pairs.

Suggestions appear in a panel on the right. Accept them one at a time, accept all, reject the ones you don't want, or regenerate for a fresh set.

Feed it your real data. On the AI prompts page you can nominate which product metafields are passed into FAQ generation — care instructions, materials, dimensions, warranty terms. FAQs written from real attributes are far better than FAQs written from a title.

Plan limits

On the Free plan, AI FAQ generation covers up to 10 products (counted as products with at least one FAQ assigned), plus a separate allowance of 10 collections. Any paid plan removes the cap. Manually written FAQs are not limited.

Importing FAQs in bulk

If you already have FAQs in a spreadsheet or another app, use Import FAQs.

Upload a CSV with three columns:

  • product_id is the numeric Shopify product ID.

  • One FAQ per row; repeat the product ID for multiple FAQs on the same product.

  • Quote any answer containing a comma.

A downloadable sample file is available in the import dialog. The import runs in the background — you can keep working while it processes.

📸 Screenshot needed — the Import FAQs dialog with the CSV format explained and the drop zone.

Displaying FAQs on your storefront

FAQs do not appear on your product pages until you add the theme block. See Installation for the steps.

Once added, the block has these settings in the theme editor:

Setting
Default
What it does

Heading

"Frequently asked questions"

The heading above the FAQ list

Output style

Styled

Styled uses the app's own layout; Raw HTML outputs plain headings and paragraphs so your theme's typography applies untouched

Collapsible accordion layout

On

Questions expand and collapse on click

Expand the first FAQ by default

Off

Opens the first entry on page load

Custom styles

Off

Unlocks the font size, colour, border and radius controls below

Custom CSS

For anything the controls don't cover

Output FAQPage structured data (JSON-LD)

On

Emits schema.org FAQPage markup

Structured data

The FAQPage structured data setting is what makes FAQs count for GEO. It emits schema.org JSON-LD describing each question and answer in a format search engines and AI crawlers parse directly — rather than hoping they infer meaning from your page layout.

Choosing an output style

Use Styled if you want the FAQs to look consistent regardless of theme. Use Raw HTML if your theme has strong typography you want the FAQs to inherit — it outputs bare headings and paragraphs with no styling of its own.

Editing FAQs from the Shopify product page

The Product FAQ admin block lets you read and edit a product's FAQs without leaving Shopify's product page. Add it the same way as the GEO score trend block.

Last updated