Frequently asked questions

Setup and embedding

How do I add the Product Insights Panel to my site? 

Enable the tests you want to show on the product, add the product's slug, then click Embed and paste the two lines onto your page. The full walkthrough is in Set up your Product Insights Panel.

Where do I get my embed code?

On the product's Product Insights Panel page in Light Labs, click Embed. It gives you the script tag and the element to paste onto your page.

Once I add a slug, does the panel appear automatically, or do I still need to add the code? 

Both steps are needed. Adding the slug tells the panel which product belongs on a page. You still place the script tag and the panel element on the page itself. The slug on its own does not put anything on your site.

Do I need a developer?

On Shopify you can usually add it yourself with a Custom Liquid block. On other platforms it is a short copy and paste into your page or theme. If you would rather we guide your developer, email support@lightlabs.com.

Can I move the panel? 

Yes. Move the embed code to wherever you want it on the page.

Will it update automatically when Light Labs makes changes?

Yes. The embedded code stays current on its own, and results update when you publish new testing.

Displays and placement

What is the difference between the panel, the sticker, and the full report?

They show the same data in different forms: an inline bar, a badge for your product image, or the full report embedded in the page. See 📄 Choosing a display: panel, sticker, or full report

Can I use more than one display on the same page?

Yes. A common setup is the inline panel near the buy button and the sticker on the product image. This is also a good way to A/B test placement.

Where should I place it?

Most brands put the inline panel below the buy button and the sticker on the product image. The full report works well on a dedicated quality or transparency page.

Products, variants, and pages

It works on my product pages but not on a landing or bundle page. Why?

Those pages do not have a single product slug to match against, so you tell each panel which product to show. The recommended way is to register an identifier you already own (your product ID or slug) on the product in Light Labs, then pass it as external-id while looping over your own products, so you never have to track Light Labs IDs. You can also fall back to the Light Labs product-id. See📄 How products are matched to pages

How does the panel know which product to show?

It matches your product slugs against the page URL. You can also target a product with an external ID you register (your own product ID, slug, or SKU), which is the recommended approach off the product page, or with the Light Labs product-id as a fallback.

The panel shows the wrong flavor or variant. How do I fix it?

Set the variant's external ID on the element, or call setExternalId. See 📄 How products are matched to pages

I added a new flavor that shares a formula with an existing one. Can it show the same results?

Yes. You can map more than one store variant to a single set of results using external IDs, so flavors that share a formula can show the same testing. Email us if you would like help setting this up.

Can I show the panel inside a product configurator or custom builder?

Yes. Since there may be no product URL to match against, use the external-id approach: register an identifier you own on each product, then set external-id per panel as the selection changes. Setups vary, so email support@lightlabs.com and we will help you find the right approach.

Results and data

When several tests are enabled, does the panel average them?

No. It shows your most recent results, never an average.

Can shoppers look up results by lot or batch?

The panel shows the most recent results for a product, not results per lot.

What happens to out of spec results?

They are not counted as passing and appear with a muted marker on the full report. We recommend only enabling results you are comfortable showing publicly.

Why does the testing date look old?

The date is when the testing was completed, from the COA. Newer testing moves it forward.

Where do the results come from?

Directly from your Certificates of Analysis in Light Labs. Nothing to re-upload.

What does the heavy metals comparison mean?

For lead, cadmium, arsenic, and mercury, the report compares the amount detected to amounts commonly found in everyday foods, to make the number easier to understand.

Appearance and customization

Can I change the colors, copy, or order of results?

The panel's result labels, category names, and order are standardized across all brands, so they are not individually customizable today. The panel's own styling is designed to look consistent on every site.

Can I open the report from my own button instead of the default panel?

Yes. You can hide the default panel and trigger the report from your own UI. See 📄 Custom triggers and the JavaScript API

Testing and previewing

Can I see how it looks before my own results are ready?

Yes. Use company-id="1" to load example data while you test placement, then switch to your own company ID.

Are there performance concerns with adding it?

No. The scripts load asynchronously and are lightweight. Running more than one on a page is fine.

Getting help

Something is not working. What should I do?

Start with 📄 Troubleshooting. If you are still stuck, email support@lightlabs.com with your page URL.