This function assigns ranks for a given point type. The function will assign ranks starting with the rank that has the lowest point requirement. Used when clicking on the “Assign users to Ranks” button in the admin area.

Depending on the number of ranks that needs to be assigned and the number of balances on your website, this function can be resource heavy. Should only be used when needed.

This function is only available if the Ranks add-on is enabled.

Available since version 1.3.2


(int) Returns the total number of users that successfully received a rank.


Param Type Required Description
function mycred_assign_ranks(
$point_type string No

The point type key. Should only be used if assigning ranks of a custom point type.

) { ... }


Example 1: Default usage

$count = mycred_assign_ranks();
printf( '%d ranks were assigned.', $count );