Channel Ratings Documentation

Rating - Display Rating Tag



Parameter Description
entry_id For Channel Entries
url_title For Channel Entries
comment_id For Individual Comments
member_id For Site Members
ci_id For Channel Images
cf_id For Channel Files
cv_id For Channel Videos
br_id For BrilliantRetail Products
collection A specific rating collection
precision This parameter allows you to specify the number of decimals to round fractions on numerical rating fields for averages. For example, a value of 1 would give you a result like this for a rating value: 4.5
thousands This parameter allows you to specify which character to use to separate groups of thousands in numeric rating fields. For example, a value of , would parse 10000 as 10,000. Default is , (comma).
fractions This parameter allows you to specify which character to indicate fractions in numeric ratings. (Decimals)
scale By default, Channel Ratings assumes your rating scale is 5. As in, your numerical ratings are out of 5 (ex: 1 out of 5 stars, 2 out of 5 stars, etc). You can however, change the scale to be out of “10” by specifying the scale parameter. When you specify this, the stars variable pairs will switch from the default of 5 graphic images to 10 when placed around your numerical rating value. Default scale is 5.
theme Since you can have your own custom themes, this parameter allows you to specify which theme to use. Default is "stars".
prefix This parameter allows you to change the default variable prefix used. This is especially useful when you are nesting tags to avoid variable collisions. Default is "rating".


Variable Description


Conditional Description
{if rating:no_rating} This tag will conditionally display the code inside the tag if there are no ratings to display.


{exp:channel_ratings:rating entry_id="{entry_id}"}
        Price: {rating:price:stars} ({rating:price:avg} of 5)
        Shipping: {rating:shipping:stars} ({rating:shipping:avg} of 5)
        OVERALL: {rating:overall:stars} ({rating:overall:avg} of 5)


Having problems setting up and/or using Channel Ratings? Support is offered from 10am to 4pm EST weekdays. Send us an email at and we will respond as quickly as we can.