Appearance #
The Appearance section controls the visual styling of your directory — brand color, button styles, map marker colors, and listing badges. It has two tabs: Brand & styling and Badges.
Path: WP Admin → Directorist → Settings → Appearance
1. Brand & styling #
The Brand & styling tab lets you apply your brand colors to buttons, links, and map markers across the directory front-end.

Brand color
Brand color is used for primary buttons, links, and accents on the directory front-end. The default is #444752 (dark gray). Change it to your primary brand color — for example, the color of your logo or main CTA button — and it will apply across the directory automatically.
Buttons
The Button Type setting controls the style of secondary buttons (such as Logout). The default is Secondary. If your theme has its own button styles, experiment with this setting to find what looks best.
Text Color sets the text color of secondary buttons. The default is #0042c7 (blue). Background Color sets the background of those buttons; the default is #bacbee (light blue). Adjust both to match your brand.

Map markers
Marker Shape Color sets the color of the map pin shape. The default is #444752. Marker Icon Color sets the color of the icon inside the pin. The default is #ffffff (white). Change these so your map pins match your brand color or stand out clearly on the map.
After adjusting these settings, click Save changes.
2. Badges #
Creating a Custom Badge #
Custom Badges let you create your own listing badges beyond the built-in New, Popular, and Featured badges. You define the conditions a listing must meet, and Directorist automatically displays the badge on any listing that matches.
Path: WP Admin → Settings → Appearance → Badges
Step 1 – Add a new badge #
- Go to Settings → Appearance.
- Click the Badges tab (next to Brand & styling).
- Click Add Badge.

Step 2 – Choose the badge type #
- Under Badge type, select Text badge (label with an optional icon)
- or Icon badge (icon with hover text).
Step 3 – Set the badge details #
- Enter an Internal name for the badge. This is for admin only — it doesn’t appear on the live site.
- If you chose Text badge:
- Enter the Visible label — this is the text visitors see on the badge.
- Optionally set an Icon from the icon picker.
- Set the Background color, Text color, and Border color.

- If you chose Icon badge:
- Set the Icon from the icon picker (e.g. far fa-flag).
- Set the Icon color using the color picker.
- Enter the Hover tooltip text — this is what visitors see when they hover over the badge on a listing.

Step 4 – Set the match conditions #
- Under Match conditions, choose how multiple conditions should be evaluated: All (AND) requires every condition to be true, Any (OR) requires at least one.
- Click + Add condition to add a rule.
- From the condition dropdown, select a field to match against:
- View count
- Listing age (days)
- Average rating
- Review count
- Is featured
- Set the operator and value for the condition (e.g. greater than, equals).
- Click + Add condition again to add more rules, or click the delete icon on the right side of a condition to remove it.

Step 5 – Save the badge #
- Click Save Changes to apply the badge.
The badge now appears automatically on any listing that meets the conditions you set.
Deleting a Custom Badge #
- Go to Settings → Appearance → Badges.
- Find the badge you want to remove.
- Click Delete Badge on the right side of that badge’s settings.

Displaying Badges on the Single Listing Page #
Badges you create are shown automatically wherever the Badges element is enabled in your listing layout. You can control this from the Directory Builder.
Path: WP Admin → Directory Builder → Single Page Layout → Listing Header tab → Quick Info
- Go to Directory Builder → Single Page Layout.
- Click the Listing Header tab.
- Under Quick Info, find Badges in the list of elements (alongside Location, Category, and Rating).
- Toggle Badges on to display badges on the single listing page, or off to hide them.
- Click the gear icon next to Badges to open the Badge Settings panel.
- In Badge Settings, toggle each badge on or off individually to choose which ones are allowed to show — including the built-in New, Popular, and Featured badges, and any custom badges you’ve created (e.g. Trendy).
- Use the drag handle on the left to reorder Badges among the other Quick Info elements.

Adding Badges to the All Listing Layout #
You can also place your custom badges directly on listing cards in the grid or list view, alongside the built-in badges. A single position can hold more than one badge at once.
Path: WP Admin → Directory Builder → All Listing Layout
- Go to Directory Builder → All Listing Layout.
- Choose Grid View or List View.
- On a listing card, find the position where you want to add a badge (e.g. top-left, top-right).
- Click the + button on that position to open the Insert Element popup.
- Select the custom badge you want to add (e.g. Trendy) from the list.
- The badge appears next to any existing badges already placed in that position (e.g. Popular and Trendy shown together).
- Click the gear icon on a position to open its settings.
A single position can hold up to 3 badges at once. If every available custom badge has already been added to a position, or the position already has 3 badges, the Insert Element popup shows nothing available.
