1. Home
  2. Knowledge Base
  3. WooCommerce Members Only
  4. Roles

Roles

Current version 2.1.13View Changelog

Changelog for WooCommerce Members Only

= 2.1.13, 2 July 2026 =
* Fixed: custom user fields of type 'Select' displayed incorrectly on the checkout page
* Fixed: translation issue with Loco Translate

= 2.1.12, 17 June 2026 =
* Fixed: hidden restricted products still appear in Related Products list
* Updated: wcmo_created_customer() now runs earlier than WooCommerce's new account notification email

= 2.1.11, 22 April 2026 =
* Fixed: restricted products can be added to the cart via URL method

= 2.1.10, 15 April 2026 =
* Added: wcmo_force_parse_query, wcmo_use_existing_tax_query and wcmo_filter_redirect_page filters
* Updated: translation files

= 2.1.9, 25 March 2026 =
* Fixed: excluded submenus on frontend navigation menu using blocks are always removed even if user has access to the page

= 2.1.8, 9 March 2026 =
* Fixed: shop page not getting restricted when used in Plans

= 2.1.7, 23 February 2026 =
* Fixed: PHP Warning when a product that assigns a role has no membership expiry
* Fixed: submenus on frontend navigation menu using blocks not getting removed when using Exclude from Menu
* Updated: check if $role is a string before adding to user role
* Updated: wpml-config.xml file
* Updated: improved license validation and messaging

= 2.1.6, 22 January 2026 =
* Fixed: conditions do not work for Country and Upload user field types
* Fixed: custom label for VAT Number not displayed on the backend
* Fixed: Roles Field Label not used on the registration page

= 2.1.5, 26 November 2025 =
* Added: style classes to the Password page form
* Fixed: PHP deprecated notices when using WooCommerce 10.3
* Fixed: PHP warning on checkout page when using User Fields

= 2.1.4, 22 September 2025 =
* Fixed: PHP Warning when saving a product in the backend and when Product Add-Ons Ultimate is active
* Updated: removed woocommerce_email_customer_details action from registration-review.php email

= 2.1.3, 2 September 2025 =
* Added: fields to set password form text and labels
* Added: setting to redirect to page after registering
* Fixed: No restriction setting in Restriction Method doesn't apply if there's an active plan
* Fixed: product prices not hidden on Woodmart theme search box
* Updated: reinstated wcmo_new_registration_email_recipient filter
* Updated: remove restricted category from the category list on the frontend product page
* Updated: removed wcmo_external_registration_approval_message filter by default

= 2.1.2, 6 August 2025 =
* Added: replacement excerpt for custom post types
* Added: wcmo_archive_pages_not_restricted to prevent archive pages being restricted incorrectly
* Fixed: PHP warning if Content Type is blank in an active plan
* Updated: refresh WooCommerce shipping transient version when updating Shipping methods settings
* Updated: ensure pages are restricted when getting value from wcmo_get_restricted_pages_by_plan

= 2.1.1, 15 July 2025 =
* Fixed: issue with checkout redirecting back to cart

= 2.1.0, 14 July 2025 =
* Added: initial Teams functionality, allowing team managers to set maximum order values for team members
* Added: option to automatically exclude restricted pages from menus
* Added: customizable emails
* Updated: find active plan ID in wcmo_get_redirect_page_id to ensure Redirect from Add to Cart Button redirects correctly

= 2.0.15, 2 July 2025 =
* Added: wcom_password_url_key to pass password via URL parameter
* Fixed: product-level Restriction method 'User' does not redirect unauthorized users if they access the product page directly
* Fixed: incorrect number of params to wcmo_is_taxonomy_term_restricted

= 2.0.14, 25 June 2025 =
* Fixed: Add to Cart replacement button on the product page does not redirect to the Landing Page

= 2.0.13, 18 June 2025 =
* Fixed: product-level Restriction method 'Password' does not redirect to password form page if no Plans are active

= 2.0.12, 14 May 2025 =
* Fixed: login link sometimes does not redirect to the My Account page

= 2.0.11, 6 May 2025 =
* Updated: wcmo_ignore_disabled_category_rules filter

= 2.0.10, 1 May 2025 =
* Added: wcmo_update_done and wcmo_ignore_disabled_category_rules filters

= 2.0.9, 15 April 2025 =
* Fixed: plan settings not saving

= 2.0.8, 14 April 2025 =
* Fixed: payment and shipping settings not saving correctly
* Fixed: allow non-Western characters as role names
* Updated: back-end performance improvements

= 2.0.7, 20 March 2025 =
* Fixed: Uncaught TypeError when using Members Only 2.0+ on PHP 8.1
* Fixed: settings in the backend using textarea not getting saved in multiple lines
* Fixed: Exclude from Menu setting removing menu items even for permitted users

= 2.0.6, 18 March 2025 =
* Fixed: registration fields not being included in admin notification email

= 2.0.5, 13 March 2025 =
* Fixed: custom labels for pre-existing fields are not displayed on the User Fields page in the backend

= 2.0.4, 10 March 2025 =
* Added: setting for front page visibility
* Fixed: value of custom user field of type select does not appear in the backend user profile page

= 2.0.3, 7 March 2025 =
* Fixed: incorrect function name

= 2.0.2, 7 March 2025 =
* Added: wcmo_disable_product_data_tab filter
* Fixed: category item can sometimes show in catalog if no plan ID specified
* Updated: set default Landing page to My account page

= 2.0.1, 5 March 2025 =
* Fixed: error in checkout page
* Fixed: shipping and payment methods not saving
* Updated: allow HTML in user field labels

= 2.0.0, 3 March 2025 =
* Added: multiple restriction plans
* Added: allow access by user
* Added: restrict access to pages, post types and taxonomies
* Added: select field type for registration pages
* Added: repeater option for custom user fields
* Added: conditions for custom user fields
* Added: options to display user fields in multiple locations
* Added: wcmo_allow_external_approval filter
* Fixed: issue with subscription roles not saving for variations
* Updated: redesigned custom user fields UI
* Updated: renamed 'Registration' menu item to 'User Fields'
* Updated: renamed Registration submenu to User Fields
* Updated: user role creation and deletion

= 1.10.22, 8 January 2025 =
* Fixed: PHP warning during checkout if there are no purchased products that assign roles after purchase

= 1.10.21, 2 December 2024 =
* Fixed: Exclude from Menu not working when using Navigation Block

= 1.10.20, 5 November 2024 =
* Added: wcmo_remove_permitted_product_ids filter
* Added: wcmo_always_show_user_products filter

= 1.10.19, 23 October 2024 =
* Added: wcmo_redirect_referring_page filter

= 1.10.18, 23 September 2024 =
* Fixed: role expiration date not getting saved as timestamp, which causes a PHP error on the Edit Profile page

= 1.10.17, 2 July 2024 =
* Added: wcmo_allow_external_approval filter
* Updated: role expiry dates in user profile now updateable
* Updated: WCMO_Updater class for PHP 8.2

= 1.10.16, 15 May 2024 =
* Fixed: some Members Only settings don't work on product pages that use WooCommerce Blocks

= 1.10.15, 4 March 2024 =
* Fixed: PHP warnings when editing the global header in Divi
* Fixed: Billing State and Shipping State fields in the registration form do not become dropdown fields if selling or shipping location is limited to United States

= 1.10.14, 25 September 2023 =
* Added: wcmo_disable_product_user_select filter
* Added: wcmo_assign_roles filter

= 1.10.13, 29 August 2023 =
* Updated: compatibility with WooCommerce High-Performance Order Storage

= 1.10.12, 29 June 2023 =
* Fixed: product categories not getting excluded when using Exclude from Menu setting

= 1.10.11, 24 April 2023 =
* Fixed: add to cart button not hidden for variable products on Astra theme
* Fixed: product count for each category does not consider restricted products

= 1.10.10, 28 February 2023 =
* Fixed: User IDs field in the Edit Product page is not hidden if Restriction method is not By User
* Fixed: pending user role causes fatal error in PHP 8
* Updated: compatibility with Product Table Ultimate
* Updated: prevent creating a new registration field with blank label

= 1.10.9, 4 January 2023 =
* Added: wcmo_override_is_restricted_category_by_id filter
* Fixed: PHP warnings when authenticating users
* Fixed: Fatal error when saving a page with products shortcode

= 1.10.8, 6 December 2022 =
* Added: wcmo_filter_category_local_rules filter
* Added: wcmo_override_is_permitted_category_by_id filter
* Added: wcmo_disable_new_registration_email filter

= 1.10.7, 5 October 2022 =
* Added: wcmo_product_restricted_user_ids filter
* Added: wcmo_force_hide_restricted_categories filter
* Fixed: removed wcmo_is_menu_item_restricted filter
* Fixed: Fatal error when an order cannot be retrieved in wcmo_assign_roles_after_purchase function
* Fixed: PHP warnings
* Updated: choose User IDs via multiple select dropdown instead of text field

= 1.10.6, 17 May 2022 =
* Fixed: parse error in functions-products.php

= 1.10.5, 10 April 2022 =
* Updated: add redirect button to archive page if specified

= 1.10.4, 5 April 2022 =
* Updated: error suppression in wcmo_hide_restricted_categories

= 1.10.3, 5 April 2022 =
* Added: wcmo_product_restriction_method_posts_per_page and wcmo_hide_from_user_roles_posts_per_page filters
* Added: delete user-specific transients when user profile is updated
* Fixed: some transients do not regenerate after they expire
* Fixed: permit across multiple categories setting not displaying correct products
* Fixed: redirect issue with password-protected subcategories
* Fixed: redirect issue on some paths with query strings
* Fixed: when adding a new user, sometimes roles do not get saved

= 1.10.2, 2 December 2021 =
* Added: option to ensure that products in multiple categories with different rules are accessed correctly
* Fixed: user can now access products with different locally set passwords
* Fixed: added options param to custom form fields
* Fixed: redirect from log-in incorrectly directing to referring page
* Updated: switched wcmo_product_passwords from transient to option

= 1.10.1, 26 July 2021 =
* Added: wcmo_locally_restricted_categories transient
* Fixed: ensure transient expiry doesn't affect user ID restrictions

= 1.10.0, 23 June 2021 =
* Added: support for role assignment fields in variable products
* Added: GUI to add registration fields
* Added: upload fields to registrations
* Added: description in registration fields
* Added: option to add registration fields to admin notification emails
* Added: save custom registration fields in user profiles
* Added: option to set reminder date
* Added: reminder email for expiring memberships
* Fixed: ensure correct products returned in [products] shortcode

= 1.9.18, 5 April 2021 =
= Fixed: parse errors in functions-products.php

= 1.9.17, 25 March 2021 =
* Added: wcmo_ignore_hidden_roles_non_logged_in filter
* Added: wcmo_ignore_shipping_for_non_logged_in filter
* Added: wcmo_ignore_payments_for_non_logged_in filter
* Added: wcmo_ignore_restricted_payments_for_non_logged_in filter
* Fixed: posts with multiple categories not restricted correctly
* Fixed: hidden user roles not restricting individual products correctly
* Updated: Billing and Shipping State fields in registration form
* Updated: removed wcmo_admin_notices

= 1.9.16, 16 November 2020 =
* Fixed: certain products still purchasable when method set to all
* Updated: allow users to access categories pages when wcmo_allow_view_products is set

= 1.9.15, 6 November 2020 =
* Fixed: prevent unrestricted products from redirecting to log-in page

= 1.9.14, 3 November 2020 =
* Added: wcmo_get_transient_expiration
* Added: wcmo_products_restricted_to_current_user_archive transients
* Added: wcmo_get_users_expiration_dates shortcode
* Fixed: parse error in functions-registration.php
* Fixed: correctly display custom user fields on profile page
* Fixed: widgets not hidden for restricted users
* Fixed: correctly update capabilities
* Fixed: user-role restriction on entire site not setting correctly
* Updated: licence key notifications

= 1.9.13, 6 October 2020 =
* Added: display custom registration fields in user profile
* Added: select field option for new registration fields

= 1.9.12, 22 September 2020 =
* Added: wcmo_user_needs_approval filter
* Added: further registration fields and priority option

= 1.9.11, 19 September 2020 =
* Added: extra registration fields

= 1.9.10, 18 September 2020 =
* Added: hide product price in widgets
* Fixed: remove add to cart button from restricted variable products
* Fixed: parse error in functions-registration.php
* Updated: performance improvement when entire site is restricted

= 1.9.9, 29 July 2020 =
* Added: referring page parameter to wcmo_replacement_add_to_cart_button

= 1.9.8, 23 July 2020 =
* Fixed: respect Access Product Pages setting

= 1.9.7, 14 July 2020 =
* Fixed: products restricted to user IDs displaying in archive pages

= 1.9.6, 17 June 2020 =
* Added: Access Product Pages and Redirect from Add to Cart Button settings
* Added: wcmo_after_assign_roles_after_purchase action
* Added: wcmo_after_update_users_role action
* Fixed: capabilities not displaying on Roles screen
* Updated: check for 'Pending' role in wcmo_email_additional_content_customer_new_account

= 1.9.5, 14 May 2020 =
* Added: wcmo_registration_form_role_label to change label for 'Role' field on registration form
* Added: automatically create 'pending' role if pending users barred from logging in
* Added: notice to pending users when they register

= 1.9.4, 23 April 2020 =
* Added: hide prices option
* Fixed: error message when user logs in without a role
* Fixed: empty registration fields not saving correctly
* Updated: prevent non-admins from editing role capabilities
* Updated: prevent the administrator role from being an option in the registration form
* Updated: translation files

= 1.9.3, 14 April 2020 =
* Added: wcmo_assign_roles_order_status option
* Fixed: payment and shipping methods not saving empty values
* Updated: prevent administrator role being set as new user role

= 1.9.2, 1 April 2020 =
* Update: check product is_object in wcmo_update_excluded_products_transient

= 1.9.1, 18 March 2020 =
* Fixed: changed is_numeric to is_object in wcmo_update_excluded_products_transient
* Fixed: shipping and payment settings not saving empty values
* Updated: retain wcmo_referrer param in URL when user enters incorrect password
* Updated: check WooCommerce is active

= 1.9.0, 3 March 2020 =
* Added: registration fields
* Added: allow user approval for specific user roles
* Added: wcmo_after_expired_user_remove_role
* Added: wcmo_new_registration_email_recipient filter
* Fixed: correctly set multiple roles for approved users
* Fixed: correctly remove 'Pending' role from approved users

= 1.8.5, 20 February 2020 =
* Fixed: redirecting to last product in query instead of product category

= 1.8.4, 14 February 2020 =
* Fixed: redirecting to last product in query instead of shop page

= 1.8.3, 12 February 2020 =
* Fixed: products restricted by user ID not displaying correctly in archives for logged out users

= 1.8.2, 10 February 2020 =
* Fixed: products restricted by user ID not displaying in archives

= 1.8.1, 27 January 2020 =
* Added: wcmo_role_expiration_date filter
* Added: Role based shipping methods

= 1.8.0, 25 January 2020 =
* Added: Expiration dates for membership roles
* Added: Role based payment methods
* Fixed: wcmo_update_excluded_products_transient queries incorrectly looking for product object

= 1.7.3, 24 January 2020 =
* Fixed: parse error in functions-admin-products.php when saving products
* Updated: removed fields parameter from wc_get_products in wcmo_update_product_passwords_transient

= 1.7.2, 20 January 2020 =
* Added: Italian translation
* Fixed: incorrect parameter in WP_Query

= 1.7.1, 9 January 2020 =
* Added: email user on approval or rejection
* Fixed: local passwords not working for non-logged-in users
* Fixed: issue with WooCommerce shortcodes displaying incorrect products

= 1.7.0, 12 December 2019 =
* Added: initial support for WooCommerce subscriptions
* Added: wcmo_remove_existing_roles filter to replace previous user roles
* Added: multiple roles support
* Added: option to prevent pending and rejected users from logging in
* Added: option to prevent automatic log in
* Added: set different default roles

= 1.6.3, 26 November 2019 =
* Added: approve / reject new user registrations

= 1.6.2, 20 November 2019 =
* Added: conditionally check menu items for user roles
* Added: redirect to referring page after logging in
* Fixed: excluded menu items respecting user role

= 1.6.1, 19 November 2019 =
* Fixed: parse error in products shortcode

= 1.6.0, 16 November 2019 =
* Added: restrict posts
* Added: hide products by user role
* Updated: set default method to no restriction
* Updated: assign user role on woocommerce_order_status_processing

= 1.5.0, 31 October 2019 =
* Added: restrict products by user roles
* Fixed: correctly remove restricted products from shortcode
* Fixed: correctly remove restricted products from WP_Query

= 1.4.2, 8 October 2019 =
* Updated: product tab ID for compatibility with Add-Ons Ultimate
* Updated: renamed wcmo_excluded_products transient to wcmo_products_restricted_by_user

= 1.4.1, 8 September 2019 =
* Fixed: prevent redirection from admin
* Fixed: correctly validate password

= 1.4.0, 16 August 2019 =
* Added: automatically assign roles on purchasing products

= 1.3.5, 13 August 2019 =
* Added: $password parameter to wcmo_redirect_url filter
* Fixed: set wcmo_excluded_products transient using WP_Query
* Updated: set autocomplete to off on password field

= 1.3.4, 28 June 2019 =
* Fixed: correctly redirect after logging in

= 1.3.3, 28 June 2019 =
* Fixed: user roles not correctly blocked from content

= 1.3.2, 21 June 2019 =
* Fixed: timeout error

= 1.3.1, 6 June 2019 =
* Fixed: correctly exclude authorised products from restrictions

= 1.3.0, 6 June 2019 =
* Added: checkbox to opt into hiding widgets
* Added: alternative label for add to cart button on restricted products
* Added: product restriction method column in products list
* Fixed: correctly check for restricted products on All Product Pages
* Fixed: correctly restrict locally protected products from archive pages
* Fixed: too many redirects when trying to access log-in page
* Updated: restructured settings page into sections

= 1.2.0, 1 April 2019 =
* Added: Members Only product panel
* Added: restrict product by user ID
* Fixed: incorrectly named password session variable

= 1.1.4, 28 March 2019 =
* Fixed: Updater error

= 1.1.3, 27 March 2019 =
* Fixed: JS error in admin

= 1.1.2, 26 March 2019 =
* Fixed: too many redirects issue

= 1.1.1, 26 March 2019 =
* Fixed: redirect not working correctly for some blocked content

= 1.1.0, 6 March 2019 =
* Added: individual category settings
* Updated: use term_id instead of slug for protected categories

= 1.0.2, 21 February 2019 =
* Added: hide restricted products in archives

= 1.0.1, 15 February 2019 =
* Added: pot file
* Added: licensing
* Updated: changed default restriction method to log-in-status

= 1.0.0, 11 December 2018 =
* Initial commit

Creating, editing and deleting user roles

  • Plugin: WooCommerce Members Only
  • Content Type: Support Document
You can manage user roles by going to Members Only > User Roles. To add, edit or delete a role:...

Set user role after purchasing a product

  • Plugin: WooCommerce Members Only
  • Content Type: Support Document
You can automatically assign user roles to customers when they buy certain products. For example, if you are selling memberships...