Adjust and return capabilities for Paid Memberships Pro based on the user’s specific role.

apply_filters( 'pmpro_assigned_{$role}_capabilities', $cap_array );

There are several built-in forms of this hook (more if you have other plugins or custom code that create additional user roles in your WordPress site). Default hook variations include:

  • pmpro_assigned_administrator_capabilities
  • pmpro_assigned_editor_capabilities
  • pmpro_assigned_author_capabilities
  • pmpro_assigned_contributor_capabilities
  • pmpro_assigned_subscriber_capabilities


array; The array of capabilities for the role named in the filter

Available capability values for Paid Memberships Pro include:

  • pmpro_memberships_menu
  • pmpro_dashboard
  • pmpro_membershiplevels
  • pmpro_edit_memberships
  • pmpro_pagesettings
  • pmpro_paymentsettings
  • pmpro_emailsettings
  • pmpro_emailtemplates
  • pmpro_advancedsettings
  • pmpro_addons
  • pmpro_memberslist
  • pmpro_memberslistcsv
  • pmpro_reports
  • pmpro_orders
  • pmpro_orderscsv
  • pmpro_discountcodes
  • pmpro_userfields
  • pmpro_updates

Return Value

@cap_array based on $role



View in Source Code

About Actions and Filters in PMPro

Hooks allow you to extend Paid Memberships Pro without editing any core plugin files. You can use a hook to program custom code that interacts with or modifies code in our plugin, Add Ons, your theme, and even WordPress itself.

There are two kinds of hooks: actions and filters.

  • Action hooks allow you to run new custom code at pre-defined locations.
  • Filter hooks allow you to change or extend existing code by modifying the data and returning it back to the software.

Click here to browse the full database of action and filter hooks available in Paid Memberships Pro. For help extending our Add Ons, refer to the individual Add On's documentation page for a list of available hooks.

For more developer-focused information about Paid Memberships Pro, check out the advanced developer topics documentation.

Was this article helpful?