Badges

The Badges feature provides merchants the ability to manage when and where badges appear on a product. This feature extends the self-serve functionality of the Athos console, similar to other merchant-driven features such as merchandising campaigns, filters, and field settings.

Badges highlight attributes of specific products, such as an item on sale, an item with a special quality like “eco-friendly”, an item that is a best-seller, or a new product. You may use badges to highlight any attribute that may entice a shopper to purchase it.

You define the style of the badge and the rules used to determine when that badge displays. You can display multiple badges on each product, controlling what causes a badge to appear, where it appears, what it displays, and which badge has higher priority. Badges can be configured for position, color, and style. The system ties each unique condition (new, bestseller, low stock, etc.) to a condition tagged by you.

Access the Badges configuration within the console by navigating to Merchandising, then clicking "Badges" in the "Visual Promotions" portion of the menu.

First, choose the appropriate tab: Left Position, Right Position, or Callout Position, at the top left of the page. This will determine the location of the selected badge. (The "callout" section is the portion of the product card where the title, price, rating stars, add-to-cart button, etc., are displayed. It is typically located below the product image and can be rather large.)

Then click the "Add New Badge" button. The Badge Design tab will appear.

Add Badge/Edit Badge window

Whether you click "Add New Badge" or you click the "..." menu and choose "Edit Badge", a similar window will appear, titled "Add Badge" or "Edit Badge". The window displays two tabs: Badge Design and Badge Behavior.

Badge Design tab

During initial site implementation, you will define where your badges will appear. This action is to style the “slots” that you can use later to set up badge rules to fill with your badge contents. Here, you define style elements that are found in the badge template, such as font, background color, padding, and spacing. Once the badge style (defined in the selected template) is chosen, the style will be applied to the badge slots.

Note: Remember to save your changes when editing or creating a badge. If you navigate away from the badge designer without saving your changes, any unsaved configurations will be lost.

Badges can be activated or inactivated per your preferences.

Note: Any entry errors will be called out with red text. In the image below, the badge name starts with an asterisk instead of a letter, so an error below the name is displayed in red.

Badge names are unique; once the badge name has been set, the name auto-populates the label in the design settings.

New badges or changes to badge behaviors are activated after indexing is completed. Other changes to the badge design or priority are applied once data caching expires – usually in 10 minutes or less.

Badge templates

Badges come with a predefined selection of styles. The image below displays an example of possible input fields, which will differ based on the selected badge template. (For customized badge templates, contact your CSM.)

Note: When creating a new badge, click the "Continue" button to move from the "Badge Design" tab to the "Badge Behavior" tab, where you will save your changes. When editing an existing badge, click the "Save Changes" button instead.

The fields in the Badge Design tab appear as follows:

Badge Name

Type in the badge name into this field. The Badge Name is a unique identifier for this particular badge configuration. Once you input the badge name, the Badge Tag will be automatically generated based on the Badge Name. Badge Tags are used specifically for customer-managed front-end integrations.

Badge Style (Badge shape)

Select a badge style (template) from the drop-down menu. To add custom badge shapes, contact your CSM.

• Pill Badge (rounded rectangle)

• Rectangle Badge

• Text Badge (text only)

• Image Badge (URL)

Once the badge style is selected, the system will display style selectors to customize the badge.

Note: The Badge Name, Badge Style, and Badge Position fields are mandatory.

Badge Position 

Once the badge has been named, select its position within the product card. Three sections of the product display are available for badges: Left, Right, and Callout (at the bottom of the product image). Users may configure a maximum of 30 badges, and there are no limits to how many of the 30 can be assigned to each section.

Note: Once a new badge is created, it shifts automatically to have the top priority in its section (left, right, or callout). To redefine a badge's priority, drag the badge up or down in the list using the grid icon at the left of each badge. Product priority defines which badge will be shown if there is a conflict. The item at the top of the list gets priority.

Note: Location-specific badges have restricted drop-down options (only left, only right, or only callout, depending on how this was configured in setup). A location-agnostic badge can be placed in any section (left or right).

Background Color

Click the drop-down menu to select a badge background color from the display, or type in an alternate color using the hex code, RGB, or HSL parameters, using the up/down arrows at the far right to select which color method to use. Use the transparency slider to select the level of transparency/saturation for the chosen color.

Text Color

Click the drop-down menu to select a text color from the display, or type in an alternate color using the hex code, RGB, or HSL parameters, using the up/down arrows at the far right to select which color method to use. Use the transparency slider to select the level of transparency/saturation for the chosen color.

Image URL

Depending on how the template is configured, you may have the option to include an image. To add an image, paste the URL of the image’s location. All common image types are accepted, including .png, .svg, .webp, .jpg, .jpeg, and .gif.

Note: The URL should begin with "http://" or "https://".

Badge Behavior tab

Once Badge Design has been configured, switch to the Badge Behavior tab to configure the rules for the badge’s behavior. Badge rules define the conditions for when a badge should be applied to a product. Badge rules can be added, modified, or deleted.

Note: All values after the value Apply Badge When are conditioned to what is available for that field in question. For example, if the field Apply Badge When has been configured for “product tag”, then all available condition options will be tag-related.

Note: The Label field is mandatory.

Label Type

Select the label input type from the drop-down list:

• Text

• Field value

• No label

Note: The available input fields depend on the style chosen for the badge.

Label Value

This field’s options are determined by the selection in the previous field, Label Type.

• If “Text” is chosen for the label input in the previous field, the content in this field will auto-update to the value in the Badge Name field when the badge name was first entered. You may replace the text here; however, if the badge name is later changed, this field will not update to match it.
• If “Field value” is chosen for this field, the input will change to a field drop-down list.
• If “No label” is chosen in the previous field, this field will be disabled.

Behavior

This section defines custom behaviors and conditions for when the badge is applied.

Apply Badge When

Click the drop-down list to select from the available options. The values here depend on the badge type and the merchant's data. Options might include how old the product is, its price, its brand, or the collection it belongs to.

Condition

Click the drop-down list to select from the available options. The values here depend on how the badge has been configured. They may include some or all of the following:

• equals

• is not equal to

• is null

• is not null

• is more than

• is more than or equal to

• is less than

• is less than or equal to

Field Value

Once the "Apply Badge When" and "Condition" values are chosen, the Field Value field will update per the previous selections.

If the field is a number, the rule can have mathematical operations such as:

• Is equal to

• Is less than

• Is more than

For example: Price is equal to <text input>.

If the field is is not a number, the rule can have operations such as:

• Is

• Contains

• Is not

For example: Color is <field value>.

By default, each location can display only one badge at a time. That setting can be adjusted by our team based on your requirements. If there are multiple rules for different badges assigned to the same location (such as the left section), the system will review the rules and determine which takes precedence based on the priority assigned.

For example, if “new” and “best-seller” badges are assigned to the same slot, you will need to set up two badge rules:

1. “New” badge: When a product has “is_new” in the ss_tags field, display “New”.

2. “Best-seller” badge: When a product has “is_bestseller” in the ss_tags field, display “Best Seller”.

If a particular product is both “new” and a “best seller”, and Rule 1 & 2 are both satisfied, the first rule in the listed order will take priority and will be shown first in that location. If your site is configured to only show one badge at a time, then additional badges for that location would not be displayed.

Note: No two badges can have the exact same rule/rule sets.

Sample badge rules

Display field value

Show the field value for badge text. For example:

When “ss_status” is equal to "New", show "New"

Display input text 

Show text input for badge text. For example:

When product_inventory less than “10”, display “Low Stock”(text input) 

Display variable text on a badge

Show discount percentage depending on the discount calculated in the badge. (You will need to create a product filter.) For example:

When ss_discount_prcnt is not 0, show ss_discount_prcnt

Note: A filter is set up to calculate the discount percentage, which is a calculated field value available in the console for a rule. For example:

ss_discount_prcnt = [(MSRP - price)/MSRP *100] + “% off”

The output of this operation is stored in the field.

Once your configurations are set, click the Discard button to remove these changes, or click the Create Badge button to save your changes and create the new badge.

Additional configurations

Make additional configurations on the main badges screen; this addresses the priority and status of each badge. You may also click the "..." button under the Options header and choose "Edit" or "Delete" for a specific badge.

Status

This column displays the badge's status: enabled or disabled. Click the button to toggle between "enabled" and "disabled".

Canceling or discarding changes

You cannot close badge creation without populating any mandatory inputs. If you opt to close the accordion with any of the following actions, a pop-up warning may appear to ask if you are sure: "Discard badge changes? You will lose all changes made to this badge". If you click “Yes”, all previous information will be discarded.

• Selecting "Discard"

• Opening another accordion

• Changing page

Click the “Discard” button or the “Keep Editing” button.