LabLinks for Shopify — App Documentation

Install LabLinks from the Shopify App Store. After you approve the installation, the app opens a four-step setup wizard inside Shopify admin:

1. Pick your industry. Choose Hemp, Food & Beverage, Supplements, Cosmetics, or General/Other. This selects the custom field template used for new lab reports.
2. Set your branding. Enter your brand name and choose primary and secondary colors. These apply to your storefront badge and portal.
3. Review your choices. Confirm the industry and appearance settings. You can change everything later in Display settings.
4. Choose a plan. Select Free, Pro, or Business. Paid plans include a 14-day trial.

The dashboard is the app's home screen. Until your store is fully set up, it shows a getting-started checklist with the four steps that take a new install to a live storefront: enable the app embed in your theme, add the badge block to your product pages, upload your first lab test, and customize your portal.

Below the checklist, the overview cards show your lab report counts — total, passed, failed, pending, and archived — and your lab report usage against your plan limit. Quick actions link to the most common tasks, and a recent lab tests list shows the latest reports you have added.

Click Add Lab Test to upload a new report. Use the product picker to link the report to a Shopify product — either a specific variant or All Variants. Upload the report file as a PDF, PNG, JPEG, or WebP up to 15 MB.

Each report carries these fields:

• Lab Name
• Test Date and Expiration Date
• Batch/Lot Number
• Status — Pass, Fail, Pending, or Archived
• Industry
• Custom fields from your industry template — text, number, percentage, and pass/fail types

Custom field limits depend on your plan: 3 on Free, 25 on Pro, and 200 on Business.

A product can hold multiple reports — one per batch — and one report per product can be marked as Default, which is the report the storefront badge opens.

The lab test list supports search by product, SKU, lot, batch, or lab name; status filter buttons; type, vendor, and industry filters; and sort options. Select multiple reports to change their status or delete them in bulk.

LabLinks ships as theme app extension blocks, so you never edit theme code. Two steps put the badge on your product pages:

1. Enable the LabLinks app embed. In Shopify admin, go to Online Store → Themes → Customize → Theme settings → App embeds and toggle LabLinks on.
2. Add the Lab Test Product Badge block to your product page template in the theme editor, the same way you add any other section element.

The badge block has settings for badge color, text color, badge text, and a click-to-view popup toggle.

Two more blocks are available in the theme editor: a batch lookup search widget and a trust banner. With the popup toggle enabled, clicking the badge opens the full report in an overlay with an embedded PDF viewer — the customer never leaves the product page.

Every store gets a searchable lab results portal at https://your-store.com/apps/lab-results. Visitors can search by product, batch, or lot number, and open any report in the viewer.

The portal also accepts direct links with ?product=, ?batch=, and ?q= parameters, so you can link to a pre-filtered view from emails, packaging, or QR codes.

Import lab reports in bulk through a multi-step flow: choose your industry, upload a CSV, map columns (LabLinks auto-detects matching headers), preview the rows, then import. Each batch can import up to 250 rows.

Supported columns include product name, batch, lot, test date, expiration date, lab name, and status, plus columns for your custom fields.

Start with the template CSV if you want a clean header row:

Display settings control where lab results appear and how they look. Toggle each surface independently: the product page badge, collection badges, the portal page, and the popup viewer.

You can also set the portal title and description, and manage branding — colors and logo. The “Powered by LabLink” attribution shown on storefront components is removed on paid plans.

Generate a QR code for a specific lab report, a product, or your portal. Customize the colors and add a logo overlay, then download the code as PNG, SVG, or PDF for packaging and print. Scan counts are tracked so you can see how often each code is used.

Analytics tracks report views, downloads, and QR scans, with trends over time. Export the data as CSV for reporting outside the app.

Paid plans include a 14-day trial. See Pricing for current pricing.