---
title: "Ratings & Reviews Merge Tags"
date: 2026-04-23
author: "GravityKit"
link: "https://www.gravitykit.com/docs/gravityview-pro/ratings-reviews/ratings-reviews-merge-tags/"
---

These Merge Tags may be used to show an entry’s rating. This is useful in combination with [GravityMath](https://www.gravitykit.com/products/math/) and inside the [Custom Content field](https://www.gravitykit.com/docs/gravityview/getting-started-gravityview/using-the-custom-content-field/).

## All types

- `{gv_entry_ratings:review_count}` The number of votes (or ratings) an entry has received.

## "Vote" type

- `{gv_entry_ratings:vote_total}` The calculated score of the entry, totaling all upvotes (+1) and downvotes (-1). If there are 5 upvotes, and 2 downvotes, the vote total will be 3.
- `{gv_entry_ratings:neutral_votes}` Number of neutral votes (ratings without an upvote or downvote).
- `{gv_entry_ratings:up_votes}` Number of upvotes.
- `{gv_entry_ratings:down_votes}` Number of downvotes.

## "5-Star Ratings" type

- `{gv_entry_ratings:average_stars}` The average star rating for the entry, rounded to 2 decimals.
- `{gv_entry_ratings:empty_star}` The number of ratings an entry has received without any stars.
- `{gv_entry_ratings:1_star}` The number of 1-star ratings an entry has received.
- `{gv_entry_ratings:2_stars}` The number of 2-star ratings an entry has received.
- `{gv_entry_ratings:3_stars}` The number of 3-star ratings an entry has received.
- `{gv_entry_ratings:4_stars}` The number of 4-star ratings an entry has received.
- `{gv_entry_ratings:5_stars}` The number of 5-star ratings an entry has received.