Certifications & Labels — User Guide

Welcome! This guide explains how to set up, manage, and get the most out of the Certifications & Labels app. It's written for brand managers, marketing teams, and product owners — no technical background needed.

1. What this app does

The Certifications & Labels app lets you display the certifications, quality marks, and regulatory labels that apply to your products — things like organic, fair-trade, ISO 9001, country-of-origin marks, or any custom badge in your brand's library.

Customers see a clean, scannable list of all the certifications relevant to the product they're looking at. You stay in control of:

• Which certifications are shown for a collection.
• Which products each certification applies to (e.g. only organic products show the organic badge).
• The order in which they appear.
• Optional custom values (e.g. a control authority reference number).

It's perfect for food & beverage brands, cosmetics, fashion, electronics — anywhere trust marks build buying confidence.

2. Getting started

When you open the app for the first time from the SmartLinks admin console, you'll land on the label configuration screen.

If you see the message "Missing collection or app context", the app was opened outside the admin console — go back and launch it from your collection's apps menu.

Your first setup in 60 seconds

1. Click Add Label in the top-right.
2. Search the global label library for the certifications your brand uses.
3. Click a label to add it. Repeat for each certification.
4. (Optional) For each label, choose which products it should appear on (see Targeting products by facet below).
5. Click Save.

That's it — the labels are now live on the public-facing certifications page.

3. Managing your labels (the editor)

The main editor is a single card titled Certifications & Labels, with two action buttons at the top:

Adding labels

Click Add Label to open the picker dialog. You can:

• Type to search by name.
• Click any label to add it to your selection.
• Already-added labels are marked so you don't add duplicates.

Note: The label library itself (the master list of certifications, their images, and descriptions) is managed centrally and cannot be edited from this app. If a certification you need is missing, contact your SmartLinks administrator to have it added to the global library.

Reordering labels

Each selected label has a drag handle (⋮⋮) on the left. Drag rows up or down to set the order in which customers see them. The first label in the list appears first on the public page.

Removing a label

Click the ✕ button on the right of any row to remove that label.

Custom value field

Some certifications (for example a control authority that requires a registration number) ask for a custom value. When you add such a label, an input field appears below it — fill in the required number or reference. The label on the field (e.g. "Authority Code") tells you what the certifying body expects.

Targeting products by facet

Below each label you'll see an "Apply to products matching" section with badges grouped by facet (e.g. Origin, Category, Certification Type).

Example: An "Organic" label with the badge Certification Type → Organic selected will only appear on products whose Certification Type facet includes Organic.

You can pick badges across multiple facets — a product matches if any selected badge matches its data (OR logic).

Saving

Click Save when you're done. The button shows:

A toast confirms success ("Label configuration updated") or alerts you to errors.

4. What customers see (public page)

When a customer scans a product or visits the certifications link, they see:

• A header showing the page title and a count (e.g. "4 certifications").
• A vertical card list — one card per certification, with:
  • The certification's badge image.
  • The certification's title.
  • Any custom value you entered (e.g. "Authority Code: CERT-2024-001").
  • A short description.
  • A Learn more link to the certifying body's website (when available).

Only certifications that match the product they're viewing are shown. The list respects the order you set in the editor.

The page is mobile-first, fast to load, and inherits your brand's theme automatically.

5. The Labels widget

This app also ships a widget that other SmartLinks apps and pages can embed to show a compact preview of your certifications.

If there are more labels than the widget can show, a +N indicator tells customers how many more are available. Tapping Open App takes them to the full certifications page.

You don't configure the widget here — it automatically reflects whatever you set in the editor. Widget placement and size are chosen wherever the widget is embedded.

6. Bulk import (CSV)

For large collections, you can prepare label assignments in a spreadsheet and import them.

CSV template

labelId,customValue,facetMatches
label_organic,,certifications:organic
label_iso9001,CERT-2024-001,certifications:iso-9001
label_fairtrade,,certifications:fair-trade;origin:france

Field reference

Examples for facetMatches:

• certifications:organic → only products tagged with the Organic facet value.
• certifications:organic;origin:france → products that are either Organic or from France.
• (empty) → applies to every product in the collection.

Imported rows are merged with your existing selection — they don't replace it. Run the import again with corrected rows to update.

7. FAQ & troubleshooting

Why don't I see my newly-added label on the public page?

Three things to check:

1. Did you click Save after adding it?
2. Does the label have facet badges selected that don't match the product? Try clearing all badges to confirm — the label should then appear on every product.
3. Is the product missing the facet value you targeted? Update the product's facets in your collection settings.

The "Apply to products matching" section says "No collection facets defined".

Your collection hasn't been set up with facets yet. Until facets exist, every selected label is shown on every product. Ask your administrator to define facets (e.g. Certification Type, Origin) on the collection.

A certification I need isn't in the picker.

The global label library is managed centrally. Contact your SmartLinks administrator to have it added — once added, it'll appear in the picker for everyone.

Can I edit a label's image, name, or description?

No — those come from the global library and are shared across all brands. You can only choose which labels to display, set a custom value, and pick which products they apply to.

My label disappeared after I selected facet badges.

Selecting badges narrows who sees the label. If no products match the badges you picked, the label won't show anywhere. Either:

• Remove some badges to broaden the audience, or
• Update your products to include the matching facet values.

My CSV import skipped rows.

Common causes: missing labelId, the labelId doesn't exist in the global library, or a typo in the facetMatches format (must be facetKey:valueKey, semicolons between pairs, no spaces).

Can I change the label order after launch?

Yes, anytime. Drag rows to reorder and click Save. Customers see the new order on their next visit.

Can I temporarily hide a certification without removing it?

Not directly. Either remove it (you can re-add it any time) or restrict it to a facet value that no products currently have.

How do I track how many people view the certifications page?

The app automatically records a "label-view" event each time a customer opens the public page. Your SmartLinks dashboard surfaces this as the Total Label Views KPI.

Need more help? Reach out to your SmartLinks administrator or contact support.