Getting started with Featured Entries
Featured Entries highlights the entries that matter most in a View and can move them to the top, such as sponsored businesses in a directory or editor’s picks in a list of events. You can feature entries by starring them in Gravity Forms, or set up featured tiers to rank them as Gold, Silver and Bronze and feature them automatically.
A tier is a group of featured entries with its own badge and row color. An entry joins a tier when it matches the tier’s conditions, such as a “Listing level” field set to Gold, or when someone pays for it on an order form.
Note: Featured Entries is included with GravityView Pro and the GravityKit All Access Pass.
On a GravityView + Extensions (Legacy) license, Featured Entries is a separate plugin. About the “GravityView + Extensions (Legacy)” license shows how to install it.
If the separate Featured Entries plugin is still installed on your site, Moving from separate extensions to GravityView Pro explains how to remove it.
Turning Featured Entries on or off #
Featured Entries is built into GravityView Pro, so there is nothing to install. To turn it off or back on:
- Go to Plugins and click Features in the GravityView Pro row.
- Click Turn off or Turn on in the Featured Entries row.
While the separate Featured Entries plugin is active, it runs instead of the built-in copy.
Tiers and badges need Featured Entries 3.0 or later. The Version column of the Featured Entries row on the same screen shows the version your site runs.
How Featured Entries works #
You set up featured entries on the form and in each View:
| Where | What you decide there |
|---|---|
| The form’s Featured Tiers page, in the form’s settings | Which entries are featured, the order of the tiers, and how each tier’s badge and row look |
| The Featured Entries tab in each View’s Settings box | Which tiers this View shows, whether featured entries move to the top, and whether the View shows badges |
Tiers belong to the form, so every View of that form shares them. A View can show all of the form’s tiers or only some of them.

Step 1 (optional): Star the entries you want to feature #
Starring is the quickest way to feature an entry, and it works with no other setup.
- Go to Forms, then click Entries, and choose your form at the top of the page.
- Click the star next to an entry. The star turns orange.
- To remove the feature, click the star again.

To see only the starred entries of the form, click Starred above the table.
If you only want to feature starred entries, go straight to Step 4. Starred entries stay featured while the form keeps its Featured tier.
Step 2: Set up tiers on the form #
Tiers let you feature entries without starring each one, and rank them.
- Go to Forms, hover over your form, and click Settings.
- Click Featured Tiers in the settings menu.
The page starts with one tier, Featured, with the condition Starred is Yes. That’s the tier your starred entries are in.
- Click Add Tier, then choose one:
- Blank tier creates an empty tier for you to set up yourself.
- Tiers from a field creates one tier for each choice of a Drop Down or Radio Buttons field, in the order of its choices.
- Tiers from an order form creates one tier for each product people can buy to feature a listing, and needs a Gravity Forms payment add-on, such as Stripe or PayPal. See Rank featured listings and sell featured spots. Until an order form exists, it explains what the order form needs.
- Click Save Tiers.

You can also get to this page from a View. In the View’s Featured Entries tab, click Set up tiers or Edit tiers. The page opens in a new tab.
Until a View uses the form, the page ends with “No View uses this form yet.” and a Create a View link. The link opens a new View with this form already chosen.

Create tiers from a field
If your form has a field such as “Listing level” with the choices Gold, Silver, Bronze and Basic, you can turn those choices into tiers.
- Click Add Tier, then Tiers from a field.
- Choose the field.
- Under Make tiers for, turn off choices that should not be featured, such as a free “Basic” listing.
- Keep featuring starred entries shows while the Featured tier for starred entries is in the list, and it starts on only when the form has starred entries. Leave it on to keep them in the Featured tier, above the new tiers. If you turn it off, the note under the new tiers has a Feature starred entries again link that puts the Featured tier back.
- Click Create tiers, then click Save Tiers.

The new tiers appear in the list below the Featured tier.

Change a tier’s settings
Click a tier to open its settings:
- Tier name names the tier in your list of tiers. The badge shows it too, unless you set badge text.
- Which entries are in this tier? chooses Entries that match conditions, Entries with a paid order, or both. When both are checked, an entry must match the conditions and have a paid order.
- Appearance sets the badge text, badge color, badge icon or image, and the Row or card color. The row or card color is pale yellow unless you choose another color, Custom for a color of your own, or No color.

The Starred condition features the entries you star in Gravity Forms, so you can combine the star with any tier.
Put the tiers in order
An entry gets the first tier it matches. If a listing matches both Gold and Silver, it shows as Gold when Gold is above Silver. Use the arrows on each tier to move it up or down, then click Save Tiers.
Step 3: Choose which tiers a View shows #
Once the View has a form and a layout, the tab lists the form’s tiers, before you save the View.
- Edit the View.
- In the Settings box, click the Featured Entries tab.
- Under This View shows, choose:
- Every tier, including tiers added to the form later.
- Only these tiers: every tier starts checked, so uncheck the tiers this View shouldn’t show. Tiers added to the form later stay hidden in this View until you check them here.
- If the form’s tiers changed while the View was open, click Refresh.
- Click Update.

Entries in a tier the View doesn’t show look and sort like any other entry in that View.
Show each entry’s badge
Visitors see badges only when the View has the Featured Badge field. If the View doesn’t have it, the Featured Entries tab shows an Add the Featured Badge field button.
- Click Add the Featured Badge field. The field is added to the Multiple Entries layout, and a message reminds you to update the View to save it.
- Click Update.

You can also add the Featured Badge field yourself, like any other field, to the Multiple Entries or Single Entry layout.
Featured Badge field settings
The Featured Badge field shows the badge of the tier an entry is in. It’s empty for entries that aren’t featured, and for entries in a tier the View doesn’t show. To change how it looks, click the gear icon on the field:
- Show as chooses Badge, with the tier’s icon and color, or Text, which shows only the badge text.
- Below that, the settings list the badges of the form’s tiers. Edit tiers opens the form’s Featured Tiers page in a new tab.
- Custom Label names the column or field, such as
Level. The settings window then shows that name as its title.

To change a badge’s text, color or icon, edit the tier on the form’s Featured Tiers page. The change shows in every View with the Featured Badge field. In a CSV export, the field holds the badge text.
Step 4: Move featured entries to the top #
Move Featured Entries to Top is off for new Views. When it’s off, featured entries keep their badge and row color and stay in the View’s usual order.
- Edit the View.
- In the Settings box, click the Featured Entries tab.
- Turn on Move Featured Entries to Top.
- Click Update.

The top tier comes first, then the next tier, then every other entry. Each group keeps the View’s sort order. To learn how this works with paging, searches and filters, see How Move Featured Entries to Top works.
How featured entries look #
Each featured entry gets the row or card color of its tier. In a Table or DataTables View, that’s the row’s background. In other layouts, it’s the entry’s card.

Style featured entries with CSS
Every featured entry has the CSS class gv-featured-entry. An entry in a tier also has the class gv-featured-tier-{tier key}, so you can style one tier without the others. The tier key is shown in the tier’s settings, and it stays the same when you rename the tier.
In a Table or DataTables View, these classes are on the entry’s row. In a List View, they are on the entry’s card. The tier’s badge has the gv-featured-tier-{tier key} class too, so a rule that names only that class also styles the badge.
This example draws a gold bar on the left of each entry in a tier whose key is 02lj88qlug. Add it to the View’s Custom CSS field, as Adding custom CSS to your Views shows:
.gv-featured-entry.gv-featured-tier-02lj88qlug:not(tr),
tr.gv-featured-tier-02lj88qlug > td:first-child {
box-shadow: inset 4px 0 0 #f2c94c;
}The first selector is for cards in a List View, and the second is for the first cell of each row in a Table or DataTables View. A box shadow draws the bar because a table row doesn’t show a left border.
Keep the rule in the View’s Custom CSS. In your theme’s Additional CSS, it doesn’t show on cards in a Vantage List View or in a DataTables View.

To change the background of a tier’s entries, choose another Row or card color in the tier’s settings, or Custom to pick any color. No color turns the highlight off for that tier.
Views you already have #
Updating Featured Entries doesn’t change your Views. Until you save tiers on a form, every View of that form features its starred entries, and Move Featured Entries to Top keeps the setting it had. The setting moved from the View Settings tab to the View’s Featured Entries tab.
