Help & FAQ

Help for merchants running LnqAI inside their Shopify admin. If your question isn't here, see Contact at the bottom.

Getting started

What does LnqAI do?

It takes the products in your Shopify store and turns them into the product feed OpenAI requires for ChatGPT Ads, then delivers that feed to OpenAI for you.

Why can't I just use my Google Shopping feed?

OpenAI's feed is not a Google-style feed. It uses OpenAI's own field names, has to be a full daily snapshot rather than an update, must be compressed (parquet or a gzipped CSV/TSV/JSONL — not plain CSV or XML), and is delivered over SFTP rather than a URL Google fetches. A Google feed will not be accepted.

What do I need before I install?

1. A Shopify store with products.
2. An OpenAI Ads account with a feed created in it. Creating the feed in OpenAI's Ads Manager is what generates the SFTP host, port, username, and password you'll paste into LnqAI. You can't get those credentials any other way.

How do I set it up?

1. Install LnqAI from the Shopify App Store.
2. Open the app in your Shopify admin. The dashboard shows your setup status.
3. Go through the setup wizard: confirm your default brand, tell us which metafield holds your brand if you use one, set your return-policy URL and target countries.
4. Run a 100-item sample. Read the completeness report.
5. Fix whatever the report flags in your Shopify products.
6. Add your OpenAI SFTP credentials.
7. Push the feed.

How long does setup take?

Most of it is a few minutes. The part that takes real time is fixing missing product attributes the completeness report finds — that depends on how tidy your catalog already is.

The feed

What is the completeness report?

Before you send anything, LnqAI checks your products against the fields OpenAI requires and tells you which ones are missing or empty. Missing required fields are the most common reason a feed is rejected on OpenAI's side, so this is worth reading carefully.

Can I see the file before it goes to OpenAI?

Yes. Run a sample and download it. You get the actual file in the actual format.

How many products can I send?

OpenAI sets no minimum and no maximum. Products are counted per variant — each variant is its own item, so a shirt in three sizes and two colours is six items, not one. An early beta had a 1,000-product floor; that is no longer in the spec.

Your LnqAI plan does have a limit: Starter covers up to 500 variants and Pro, our largest plan, up to 10,000. If your catalog is over your plan's limit, the daily delivery is held rather than sent short — we would rather stop than have you advertising a partial catalog without knowing. Running a sample and downloading the file are never capped, so you can always see what your feed looks like.

The only other sizing guidance is on the file itself — OpenAI recommends up to around 500,000 items per file shard, with each file under about 500MB. LnqAI handles that for you.

How often does the feed update?

Once a day, automatically, on either paid plan — you don't have to be logged in. You can also push manually at any time from the dashboard, and you can turn the daily push off there if you would rather send it yourself.

What if a product is missing from my feed?

Products can be excluded because they're missing a required attribute, are out of stock, or fall outside your configured target countries. The completeness report is the place to look first.

Does LnqAI change anything in my store?

No. The app requests read-only access to your products, inventory, and store policies. It cannot edit, create, or delete anything.

Credentials and security

Where do my SFTP credentials come from?

OpenAI's Ads Manager, when you create a feed there: Tools → Feeds → Create Feed. It hands you the host, port, username, and password.

Are my credentials safe?

Your SFTP password is encrypted at rest in our database and is never shown back to you after you save it. It's decrypted only at the moment a feed is delivered.

Do you store my product data?

No. Your catalog is read, turned into the feed file, and sent. We don't keep a copy.

Do you access my customers' data?

No. The app never requests access to customers, orders, or checkouts. See theprivacy policy.

Billing

Is there a free plan?

No. Starter is the entry plan at $12.99/month and Pro is $29.99/month, both with a 7-day free trial. What you can do without a subscription is set the app up, run a sample, read the completeness report, and download the feed file — so you can see exactly what LnqAI produces from your own catalog before paying. Delivering the feed to OpenAI on a schedule is the part a plan unlocks.

What's the difference between Starter and Pro?

Catalog size, and how quickly we answer you. Both include the automated daily delivery, the completeness report, samples, and downloads. Starter covers up to 500 product variants; Pro covers up to 10,000 and puts your support emails ahead of the queue.

How am I charged?

Through Shopify. The charge appears on your regular Shopify invoice — LnqAI never asks you for a credit card and never sees one.

How do I upgrade or downgrade?

From the app in your Shopify admin, which hands you to Shopify's own plan page. Changes take effect through Shopify's billing and you don't need to reinstall.

What happens if my subscription lapses?

The daily delivery stops. Your setup and credentials stay where they are, so resubscribing picks up where you left off — but nothing is sent to OpenAI in the meantime.

Troubleshooting

The push failed. What now?

The dashboard shows the last run's status. The most common causes:

• Wrong SFTP credentials — re-copy them from OpenAI's Ads Manager. They're easy to mistype, and the password is long.
• Feed deleted on OpenAI's side — if the feed connection in Ads Manager was removed, the credentials stop working.
• File too large — OpenAI recommends each feed file stay under about 500MB, or around 500,000 items per shard. Very large catalogs may need sharding.

OpenAI only lets me connect one feed. Is that a problem?

That's an OpenAI limit — one feed per ad account. If you need separate feeds for separate markets, you need separate OpenAI ad accounts.

I uninstalled. Is my data gone?

Yes. Uninstalling triggers deletion of your configuration, credentials, and access tokens.

Contact

Still stuck? Email support@lnqai.io. Include your.myshopify.com domain and roughly when the failed run happened — that's enough for us to find it.