Skip to content

Featured Icons

Menu Location: Products > Online Store > Featured Icons

Overview

The Featured Icons page is where you build a catalog of small badge icons that can be attached to individual products so shoppers see them in your store. Each icon is an image you upload, plus a name and a short description. Icons are attached to products one product at a time from that product's own edit page, they are not created "onto" a product from this page.

When a shopper clicks a badge on a product in the shop, a popup opens showing the icon's name and its longer description (if you set one, otherwise it falls back to the short description).

Primary Functions:

  • Create icon entries (upload an image, give it a name and description)
  • Edit or delete existing icons
  • Attach or remove icons on individual products from that product's edit page
  • Icons render as clickable badges on products in the store, opening an info popup on click

Page Layout

Header Section

  • Page Title: "Featured Icons"
  • Add New Icon: button/link to create a new icon entry

Icons List Table

Displays all existing icons with columns:

  • Icon Image: thumbnail of the uploaded badge image
  • Name: the icon's name
  • Description: the short description
  • Long Description: the optional longer popup text
  • Edit/Delete Actions: modify or remove the icon

Icon Editor

  • Name (required)
  • Description (required)
  • Icon Image (required, upload)
  • Long Description (optional)
  • Save/Cancel Buttons

Create New Icon

Steps:

  1. Click Add New on the Featured Icons list
  2. Fill in the icon's properties (below)
  3. Save the icon

Icon Properties

Name (Required)

  • Shown to customers: it's used as the badge's title text on the storefront and as the heading of the info popup when a customer clicks the badge

Description (Required)

  • A short, one-sentence description of the icon
  • Shown to customers as part of the badge's tooltip, and used as the popup body text if no Long Description is set

Icon Image (Required)

  • The actual image used as the badge. Whatever you upload here is exactly what displays on the product, there is no separate color/style setting, the image itself defines the look
  • Displays at roughly 54x54px on product listings and 100x100px in the info popup, so keep the source image simple and legible at small sizes

Long Description (Optional)

  • Two to five sentences describing the icon further
  • Used in the popup that opens in the shop when a customer clicks the badge (if left blank, the popup shows the short Description instead)

Assigning Icons to Products

Icons are attached to a product from that product's own edit page, not from the Featured Icons page.

Steps:

  1. Go to Products, then open the product you want to edit
  2. Find the Feature Icons section (it links back to this Featured Icons page to add/edit icons)
  3. This section lists every icon in your catalog as a small thumbnail with a checkbox
  4. Check the icons that apply to this product
  5. Save the product

A product can have more than one icon checked at once, all checked icons display as separate badges on that product in the shop. Badges display in the order the icons were created (oldest icon first).

Remove an Icon from a Product

  1. Open the product's edit page
  2. In the Feature Icons section, uncheck the icon
  3. Save the product

There is no bulk-assign or bulk-remove tool, assignment is done per product.

Managing Icons

Editing Existing Icons

Steps:

  1. Find the icon in the Icons List
  2. Click Edit
  3. Change the Name, Description, Icon Image, and/or Long Description
  4. Save

Changes apply immediately to every product the icon is attached to.

What You Cannot Change:

  • Icon ID (system-generated)

Deleting Icons

Steps:

  1. Find the icon in the list
  2. Click Delete
  3. Confirm

Deleting an icon removes it from every product it was attached to and deletes it permanently, there is no undo. Consider whether you actually want the icon gone from all products before deleting it.

Common Use Cases

Use Case 1: "Organic" Badge for Certified Products

Goal: Visually identify certified organic products

Steps:

  1. On Featured Icons, click Add New
  2. Upload an "Organic" badge image, set Name and Description
  3. Save the icon
  4. Open each organic product's edit page
  5. Check the "Organic" icon in the Feature Icons section and save

Result: Certified organic products display the badge in the shop.

Use Case 2: Temporary "Sale" Badge for a Weekly Promotion

Goal: Highlight products on sale this week

Steps:

  1. Create a "Sale" icon (image, name, description)
  2. Open each product on sale and check the "Sale" icon
  3. When the sale ends, go back to each product and uncheck the icon (there is no automatic expiration, removal is manual)

Result: Sale products are marked while the promotion runs.

Use Case 3: "New Product" Badge for Recent Additions

Goal: Highlight recently added products

Steps:

  1. Create a "New" icon
  2. Check it on newly added products
  3. Uncheck it manually once the product is no longer new (no automatic expiration exists)

Use Case 4: "Local" Badge for Regional Products

Goal: Identify locally sourced products

Steps:

  1. Create a "Local" icon
  2. Check it on products sourced from local farms
  3. Update as which products qualify changes over time

Use Case 5: Multiple Icons on One Product

Goal: A product that is organic, local, and new

Steps:

  1. Open the product's edit page
  2. Check the "Organic," "Local," and "New" icons together in the Feature Icons section
  3. Save

Result: All three badges display on the product; there is no priority setting, badges show in the order the icons were originally created.

Troubleshooting

Icon Not Appearing on a Product

Check:

  1. Is the icon actually checked in that product's Feature Icons section?
  2. Was the product saved after checking the icon?
  3. Is the Icon Image uploaded correctly (not a broken/missing file)?

Solutions:

  1. Re-open the product's edit page, verify the checkbox is checked, and save again
  2. Re-upload the icon's image on the Featured Icons edit page if it's missing or broken

Icon Image Not Displaying Correctly

Check:

  1. Was a valid image file uploaded for Icon Image?
  2. Is the image legible at a small size (badges render around 54x54px)?

Solutions:

  1. Re-upload the icon image
  2. Use a simple, high-contrast image that still reads clearly at small sizes
  • Products - open a product's edit page to attach or remove icons on it
  • Featured Products Sort - a neighboring Online Store setting for ordering featured products

Typical Workflow:

  1. Create the icon(s) you need once, on this page
  2. Attach them to relevant products from each product's own edit page
  3. Remove or delete icons manually when they're no longer relevant

Best Practices

Icon Design

  1. Keep the image simple - it needs to read clearly at roughly 54x54px on product listings
  2. Keep the Name and Description short and clear - they show to customers as the badge's tooltip and popup heading
  3. Use Long Description for detail - save the fuller explanation for the popup, not the short Description

Icon Catalog

  1. Keep the catalog small - fewer, well-understood icons (Organic, Sale, New, Local) are easier for customers to recognize
  2. Delete icons you no longer use - deleting removes them from any product they're still attached to

Product Assignment

  1. Don't over-icon a single product - a handful of badges is easier to read than many
  2. Remove time-limited badges manually - there's no expiration date field, so remove "Sale" or "New" badges yourself when they no longer apply

Quick Reference Card

Task Action/Location
Create new icon Featured Icons page > Add New
Edit an icon Featured Icons list > Edit
Change icon name/description Edit icon > Name / Description fields
Replace the icon image Edit icon > Icon Image upload
Add popup detail text Edit icon > Long Description field
Attach icon to a product Open that product's edit page > Feature Icons section > check the icon > Save
Remove icon from a product Open that product's edit page > Feature Icons section > uncheck the icon > Save
Delete an icon entirely Featured Icons list > Delete

FAQs

How many icons can I put on one product?

There's no hard limit, every icon you check on a product's edit page displays as a badge. In practice, a handful is more readable than many.

Are icons generated badges or uploaded images?

They're uploaded images. There's no built-in generator for colored/text badges, whatever image file you upload for Icon Image is exactly what displays, so design the graphic (including any text baked into it) before uploading.

Can customers click an icon for more information?

Yes. Clicking a badge in the shop opens a popup showing the icon's Name and its Long Description (or Description if no Long Description was set).

Do icons affect search or filtering?

No, icons are visual only. They aren't tied into product search or category filtering.

What's the difference between an icon and a product tag?

An icon is a visual badge shown on the product with an info popup. Product Tags are a separate admin feature for organizing/finding products and are managed on their own page.

Can I reuse the same icon across many products?

Yes, that's the normal use, create the icon once and check it on every product it applies to.

Do I need a separate icon for every small variation (e.g. different discount amounts)?

No, keep the catalog small and reuse the same icon (e.g. one "Sale" icon) across whatever products currently qualify.