Home / Add-ons / Ranks


Reward your users with rank based on their total accumulated- or their current balance.

While Badges are based on a users points history, Ranks, are soley based on a users total or current balance. As of myCRED 1.6 you can create a rank for each point type you might have setup.

Frequently Asked Questions

No questions found for this add-on.

Related Tutorials


Installation & User Guides

Rank settings for each custom point type


Add-on Setup

  1. Go to the myCRED > Add-ons page in your admin area.
  2. Click on the “Ranks” title in the list.
  3. Click on the “Enable” button.
  4. Visit first the myCRED > Settings page and click on the “Ranks” title in the list.
  5. Set what features you want to enable for each rank such except, content or comments.
  6. If you want to show an archive of ranks on your website make sure you select to make ranks “Public”.
  7. If you have BuddyPress or bbPress installed you can select to insert ranks into the users profile or forum replies.
  8. Save.
  9. If you are using multiple point types, go to your custom point types settings page and adjust your rank settings for each point type you have setup.
  10. Done!

Rank settings for the main point type


Disabling the Add-on

  1. Go to your myCRED > Ranks page and make sure you delete all existing ranks. Do not leave them in the trash.
  2. If you are using multiple point types, visit each point types Settngs page and under “Management” click on “Remove Ranks” button. Repeat for all point types.
  3. Go to the myCRED > Add-ons page in your admin area.
  4. Click on the “Ranks” title in the list.
  5. Click on the “Disable” button.
  6. Done!

Current Balance

If ranks are based on your users current balance (default), your users will be promoted when they gain points and reach the next rank or get demoted if they lose points. This option is suitable where your users do not spend points in stores for example which would result in them potentially getting demoted.

Total Balance

If your users going to spend points and you do not want them to be penilized by demoted to a lower rank you should choose to base your ranks on a users total balance. The users total balance is calculated by adding up all point gains and remove any deductions an administrator has made. This is intended as a “fail safe” for site admins allowing them to demote a user by removing points via the Manual Adjustment feature in myCRED.

Administrators by default are allowed to adjust any users balance and select not to add a log entry with the adjustment. It is important to remember that if you do not add a log entry with your adjustment, this adjustment will not be taken into account when calculating the users total balance!

Creating Ranks for the first time

When you enable the Ranks add-on for the first time the add-on will add one default rank to your website which will have a point requirement from 0 – 9999999. When adding new ranks you should edit this rank first and adjust it’s title and points requirements. It should be the first rank a user gets.

Do not delete the default rank! If you do, myCRED will add a new one!


Adding a new Rank

  1. Go to the points types > Ranks page in your admin area.
  2. Click on the Add New button on the top of the page.
  3. First we need to give this rank a title. This is what is shown to the user.
  4. Next we need to set the minimum and maximum requirements for this rank and if you are using multiple point types, the type you want to use.
  5. If selected enter in any other post related details such as content, excerpt etc.
  6. If you want to use an image for your rank set the “Feature Image” which is used as the “Rank Logo”.
  7. Save.
  8. If you are ready to use this rank, click “Publish”.
  9. Repeat for each rank.

Auto Assignment

myCRED will automatically assign ranks to your users when:

  • A users balance changes.
  • A user is added.
  • A new rank is Published.

If you have selected to “Recalculate Totals” for your users you need to also manually re-assign ranks.

Manual Assignment

In case something goes wrong, an administrator can always manually assign ranks to users by visiting the Settings page the particular point type and clicking on the “Management” title in the list.

Here the “Assign Ranks to Users” will run through all your users and assign the appropriate rank to each one.

Available Shortcodes

mycred_my_rank – This shortcode allows you to show a specific users rank or the current user viewing the shortcode. Only shows rank for one particular point type.

mycred_users_of_rank – This shortcode will return a list of users with a particular rank.

mycred_users_of_all_ranks – This shortcode will run through each rank and present by default 10 users of each rank.

mycred_list_ranks – This shortcode will list all existing ranks for a particular point type.

mycred_my_ranks – New in 1.6, this shortcode will return all ranks a user has. Should only be used when you have ranks for more then one point type.


The Ranks add-on can insert into BuddyPress profiles each users rank. Go to the myCRED > Settings page and click on “Ranks” in the list to enable this feature.


The Ranks add-on can insert intobbPress replies and in the bbPress user profile, each users rank. Go to the myCRED > Settings page and click on “Ranks” in the list to enable this feature.

User Related Template Tags

When a log template in myCRED supports User related template tags you can use the %rank% and %rank_logo% template tags to show a users rank.

If you are using ranks for multiple point types you can show a users rank for a particular custom point type. The above two template tags will show your default point type only!

If your custom point type is set to “customtype” then you can get the rank title by using %rank_customtype% and the rank logo via %rank_logo_customtype%.


Ranks are a custom post type in WordPress set to always support Titles and Featured Images. Users can select to add support for further post features if needed. By default the post type is set to be non-public but if selected to be “Public” a post type archive can be created to show ranks.

The post type key is mycred_rank which can not be changed. All other post type arguments can be adjusted via the mycred_register_ranks filter.

Post Meta

The following post meta are used for ranks:

mycred_rank_min – Holds the minimum amount requirement for the rank.

mycred_rank_max – Holds the maximum amount requirement for the rank.

ctype – New in 1.6. Holds the point type the rank is connected to.

User Meta

When a user is assigned a rank, they receive a custom meta that stores the rank post objects ID.

For the default point type the meta key is mycred_rank and for custom point types it is mycred_rank_pointtypekey.

Last edited October 8, 2015