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.

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.

Applying FAQs to related products

Colour variants sold as separate products, the pieces of a set, the sizes of one wetsuit — these usually need the same FAQs. Instead of opening each product in turn, you can have an FAQ land on the whole group as you add it.

Set it up once. On AI prompts → FAQ Generation, choose a metafield under Product grouping. The list shows your product metafields that link to other products — for example the one Product stitching fills in. Leave it on None and the Product FAQ page works exactly as it always has.

Then, on the Product FAQ page, any product that links to others shows a row headed Also apply to related products: with a thumbnail for each one. Hover a thumbnail to see the product's name.

• Every related product starts selected. Click a thumbnail to leave that product out; click again to bring it back.

• Whenever you add an FAQ to the product — written by hand, accepted from the AI suggestions, or connected from your library — it is added to the selected products at the same moment.

• The row doesn't appear on a product that links to no others.

What happens on the related products:

• They get the same FAQ, not a copy. Edit it later and it changes on every product in the group — the same shared FAQ behaviour as anywhere else.

• Their own FAQs are kept. The new FAQ is added to the end of each product's list; nothing is removed or reordered, and an FAQ a product already has is never added twice.

• Deselected products aren't touched.

• Only adding is shared. Removing an FAQ, reordering, or choosing Edit this one only affects just the product you're on. FAQs a product already had before you set up grouping stay where they are.

If a related product can't be updated, a red notice under the thumbnails names it and says why. The FAQ is still saved on the product you're working on and on every other related product.

The group comes from the product you're on. Its metafield decides which products are related — it doesn't matter whether those products link back. Only directly linked products are included, not the products they link to.

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

AI FAQ generation is not capped on any plan, including during the 7-day Pro trial. Manually written FAQs are never limited either.

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,question,answer
8123456789,Is it machine washable?,"Yes — cold gentle cycle, hang dry."
8123456789,Does it ship internationally?,"Yes, to most countries."
8987654321,What sizes are available?,"S, M, L and XL."

• 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.

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.

Leave structured data on unless you already emit FAQPage markup elsewhere. Two sets of FAQPage markup on the same page can produce duplicate or conflicting results. If another app or your theme already outputs it, turn one of them off.

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.

Related pages

• Collection FAQ — the same editor, for collection pages.

• AI prompts — edit the FAQ prompt, choose which metafields feed it, and set the product grouping.

• Product stitching — builds the product links a grouping can use.

• Plans & billing — FAQ generation limits per plan.