# WP User Manager > WP User Manager is a WordPress plugin for user registration, login, user profiles and member directories. The core plugin is free on WordPress.org and includes registration and login forms, profiles, an account page, a member directory, content restriction and paid registration with Stripe. Paid addons on wpusermanager.com add custom fields, multiple registration forms, WooCommerce, user verification, groups and more. --- # Attaching Files to the New User Emails URL: https://wpusermanager.com/article/302-attaching-files-to-the-new-user-emails/ Last updated: 2023-01-19 As of WP User Manager 2.8 you can customize both the email sent to the user at registration as well as the notification email sent to the stie admin, via Users > Emails: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/62179d741173d072c69fb79b/file-HcN9InJ9o5.png) If you have [configured file fields](https://wpusermanager.com/addons/custom-fields/) to appear on the registration form, you can choose to attach those files submitted to either of the above emails. You can do this by editing the field from Users > Custom Fields, and navigating to the 'Emails' tab in the field settings: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/62179e0f1c416e446e804514/file-XNZpycZTiA.png) --- # Preventing access to whole site unless a user is logged in URL: https://wpusermanager.com/article/301-preventing-access-to-whole-site-unless-a-user-is-logged-in/ Last updated: 2024-03-12 With WP User Manager v2.8 it is possible to completely lock a site down to prevent access to pages unless a user is logged in. This setting can be enabled via Users > Settings > General > Login Settings. You will need to enable the 'Prevent site access to visitors' setting: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/62179ae3efb7ce7c73443852/file-2KGuAr3XGr.png) When this setting is enabled, any visitor to the site who is not logged in will be redirected to the login page (defined in Users > Settings > General). This means they can't view any of the site until they are logged in. You can still allow access to the registration page with the 'Allow site registration'. This will allow access to the page set as the 'Registration Page' in Users > Settings > General. If you have multiple registration pages using the [Registration Forms addon](https://wpusermanager.com/addons/registration-forms/), then you can add those URLs to the allowed list with the 'wpum\_registration\_pages' filter, eg. https://gist.github.com/wp-user-manager/bfebdff114805276feb83ffe8cc6d064 --- # Password Reset Not Working URL: https://wpusermanager.com/article/294-password-reset-not-working/ Last updated: 2021-09-02 Are your users seeing the following message after clicking on the email link to reset their password: "The link you followed may be broken. Please check that you used the right reset link or request a new one." This is due to page caching and you will need to make sure the [WP User Manager pages are excluded from the cache](https://wpusermanager.com/article/293-compatibility-with-caching) either in a plugin or with your hosting. --- # Compatibility with Caching URL: https://wpusermanager.com/article/293-compatibility-with-caching/ Last updated: 2021-09-11 Excluding pages from the cache ------------------------------ If using a caching plugin, make sure you exclude the following pages from the cache through their respective settings panels (the slugs are the defaults used by the plugin installation, but they might be different on your site): - Login Page (/login/) - Password Recovery Page (/password-reset/) - Registration Page (/register/) - Account Page (/account/) - Profile Page (/profile/) - Pages with the 'wpum\_user\_directory' shortcode These pages need to stay dynamic since they display information specific to the current member. The pages configured are in Users > Settings > General, and you will need use the page slug when exlcuding in plugins or hosting: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6130873c59c15b39b66c3609/file-71jGhi5zLc.png) **Hosting Caching** ------------------- ### ****WP Engine**** WP Engine, like many WordPress managed hosts, aggressively cache site pages. To exclude the following pages from the cache, you need to ask WP Engine through your user portal to exclude the /password-reset/ page from the cache. See [https://wpengine.com/support/cookies-and-php-sessions/#Exclude\_Pages\_from\_Cache\_when\_Cookie\_is\_Present](https://wpengine.com/support/cookies-and-php-sessions/#Exclude_Pages_from_Cache_when_Cookie_is_Present) **Caching Plugins** ------------------- ### WP Super Cache WP User Manager is compatible with [WP Super Cache](https://wordpress.org/plugins/wp-super-cache/). Please ensure that the the above pages are excluded from the cache by placing the corresponding endpoints here **WP Admin > Settings > WP Super Cache > Advanced.** --- # Editing WordPress User Roles and Capabilities URL: https://wpusermanager.com/article/271-editing-wordpress-user-roles-and-capabilities/ Last updated: 2021-03-06 With the release of WP User Manager version 2.4, came the release of the Roles Editor feature. The Roles Editor easily allows you to manage the user roles that you have available on your WordPress site. It also allows you to create custom roles and capabilities (permissions) for both existing and new roles that you'll be creating. After creating or updating the roles, you can either assign these roles by default to your newly registered users, or you can assign it to them after they register on your site. ![](https://lh6.googleusercontent.com/6soINVmjPXn4dGV8-YkBVyhcPYVFSDZEg1rZ0zZx0WOVtICQ3XKzeujGOfY46sYPDi9nqL0LIfbGpSDD2nXDulqZOdh6oIJ0Q-_w6Op4MWl3Php1QYC4M__wWhdYilRhXs25k9Fe) The Roles Editor The Roles Editor can be hidden by default to prevent misuse since one change can affect a lot of users at once. Here's what you need to do to disable the Roles Editor: 1. Navigate to USERS > SETTINGS![](https://lh5.googleusercontent.com/rRdCBDWTS37bbSnCzvakZ5dLHKWuSnOK56ZrOvzrq2ARE6TgnkmT41iWLEyMg4Lx5iID3aKb9SiMGWt4uGWTcYCvpKCiG2zD876SxWbJf62oQsjIgAS8yu4wR98Z0CdXolG5ZJxw) 2. Under the General tab, click on the Misc Settings sub tab 3. Scroll down to the “Roles Editor” menu and untick the checkbox![](https://lh4.googleusercontent.com/688GT7iJfwdmDoLni4YV5qijwm0MB2d1poMRdsMiEXBQvsrvQKEmzR1yN8Ti_CxIdQN2-7eEI0k4lk9bdtcjozWhtEWy5LjkQMP5Pu7eRF5V5x9qMT6KYxjbpd8sEqUP-hpU1ELK) 4. Click on the "Save Changes" button Now that we've enabled the Roles Editor, you can find it under USERS > ROLES. ![](https://lh4.googleusercontent.com/fSyb0H48EfGdRwjv1dbwXkLO_T3dWsh-ceLJgAFTi_XdzVXFWnnxY-qo7U452cld-UVqfyKRcvo3B22qlSE2rz5SnFnXGyrZhSz0xTRxQ-85U6XD-ScPXCXTwmPaKDF7uxeswtXg) NOTE: By default, only administrators can enable and disable the Role Editor. Default Roles ------------- Once you have the Role Editor enabled, you can clearly see the default roles that WordPress have on your site. ![](https://lh6.googleusercontent.com/Jw91VC_2F7SQBu6HKXHRPnr4doS2rGL3U7-P8mQvgUU4L1VlUvIJgxlvVLGPg1WezzsuGbz9R5MklbZYquGsOK7FmKl8WPMTutsu8sB9ns84zoEDZO2bfNZ-DU8UwMZpg8iZm73M) If you can see more than the default ones, those maybe custom roles created by other plugins on your website. Most LMS, Membership plugins, and eCommerce plugins create their own roles to facilitate a more efficient data management. It’s best to leave these roles alone since making changes to these roles may affect a lot of users that are already assigned these roles on your WordPress site. Adding a New Role ----------------- The Role Editor also allows you to create your own custom roles, that you can assign specific permissions or capabilities on your WordPress site. You may need a user who can only update plugins, or only update posts, etc. This feature is really useful for those use cases. NOTE: Creating a new role in WordPress is different from creating new users. These are different processes. You can assign a role to a user after they’ve registered to your WordPress site. In case you want to add a Custom Role to your WordPress site, here are the steps: 1. Turn on the Role Editor, following the instructions above. 2. Navigate to USERS > ROLES 3. Click on “Add New Role”![](https://lh4.googleusercontent.com/4cLqPVX1dQHXOdBi97Va5APQ2h9Hss8HTJEJ4fGnwmnNIFjzHUVS1zsF-soM5XWwv0SOxSOQnAgod-a4VWyaMaZz8JWkfw0zCebli3dPLsJnRVmagE9wSxtqo6FvqFAn3hIsufex) 4. Add the the Role Name![](https://lh3.googleusercontent.com/HN983_rmsiUZin3bG_bA1CI0cjoPqSRnr_qtFFhmpKmmVzjIsRURaQYFG8FNfAaUqUXtxVu9eCWi3QGxD_EVyc7KxP8bbARGHsF1-m6A3Af_rqJHvglOuHjDIrAt6OO9m6qY1-06) 5. Click “Create Role” and proceed with adding Capabilities to the role that you created Once you’re done creating the custom roles and adding capabilities to the new role that you created, you can now assign these roles to the users that're already registered to your website. Editing Existing Roles ---------------------- As mentioned above, WordPress or other plugins will already have existing roles on your site that will appear on the Roles Editor where you can also update the permissions allowed for these roles. NOTE: Please take note to exercise caution when updating permissions on existing and default roles on your WordPress site. Since if you have a lot of users registered on your site, any small changes can affect a lot of your users. Here are the steps that you can follow to update existing roles on your website: 1. Turn on the Role Editor, following the instructions above. 2. Navigate to USERS > ROLES 3. Click on the “Edit Capabilities Button” next to the role name that you’d like to edit![](https://lh4.googleusercontent.com/dRkHB8HjcM5S1pqGwOvsu-JoMHR3PUoh7z0Z3mK8gZjr69YHsbwk2-IGsGaLUBR34jnw4Tr-vP_np4bafwZe7Tm0KIhEHLevRa11dmyEJRJohx9MOLIiw_kP53ky1BmHz2pFo33W) 4. Make necessary changes to the capabilities to the roles that you’ve selected. 5. Click on “Save Changes” once you’re done editing![](https://lh6.googleusercontent.com/Si8YjR0L0cjKryb8nol4dQj1KglXMldK2U0G6Jvdd60mFDlx-X6LVS8Px1w08m1Fil-yWkyF8eNlAv5_Kl2L5qh95SqogTf5C7eBF5k2I2DACScaxfxmPDIJe9LszgHlWi0J14q5) The changes in permissions will take effect immediately. Adding and Removing Capabilities -------------------------------- Adding and removing capabilities is a useful feature in case you overlooked something when creating a custom role and need to change it, or cannot find the built in options on your plugins’ custom roles to update the permissions. Here are the steps in adding and removing capabilities using the Roles Editor 1. Go to the Role Editor 2. Click the “Edit Capabilities” button on the right side of the role that you’d like to update 3. On the left sidebar, you can select the specific category of capabilities or permissions that you would like to update![](https://lh5.googleusercontent.com/KnqYSX9aMYknrNcOj7UlXyQ1SSWFamjFKqtJZW24S_Pu3pF0n7izUFZ8_uk4oP8XnwyS5HB6jLhkokAJp6N_HBkQia2g5YFLoxykyqOKqUM21d8uyXblD1vJI20_XOa9mOCpUgWI) 4. Check/Uncheck the necessary roles that you’d either like to Grant/Deny with the selected user. ![](https://lh5.googleusercontent.com/lGRz3Mcs2RwY-DA2zTRWtYd_SU72RQ6pk2s7qehFdzLqVvMRn7FPD37HpHRnXPSiiszAggz0FC6ZYQ-NMQzQjGF8VAJ-dtp-pRdnbbaQq4uu18B8m7yHN_atLhj3FCAkFyRKJ7Ix)NOTE: Leaving them unchecked will leave the default permissions in effect for that specific role and capability. 5. Once you’re done editing, click “Save Changes” ![](https://lh5.googleusercontent.com/BlV0ZRf-r_LY1oU9ZIiW90jKiGx5zJ6HZPqmh2VsYrA5b_FsRGASKqSZldVivZZdzL1DgpDeqMyFZaTip3S3yYAUYdgm9dfYmcn7mK3gZsNCoAdwYSNLwWh7PbaCMKURsRbNQ-YY) TIP: If you’d like to instead see all the permissions and capabilities available for you to update, you can scroll down and select the “All” tab on the left sidebar and browse through the appropriate roles and capabilities that you’d like to update. ![](https://lh4.googleusercontent.com/rtsRakjPVuHxr3GZVES6cD-7okX8AE6PXOQrXnstdOFux7SMaieHRLEXyWH7-R1Aq66yCqdBJobFaMeTmqbzpoFv9bw4Sq4EwUav8ggz1Sj2BfprFW8zkzy72t_bhIs4ky4lQKyw) The available roles and categories also depend on the specific plugins that you have enabled on your WordPress site. Different plugins may add different capabilities that you can customize per role. --- # Restricting Access to the WordPress Dashboard URL: https://wpusermanager.com/article/256-restricting-access-to-the-wordpress-dashboard/ Last updated: 2020-12-28 WordPress users will by default have access to the wp-admin WordPress dashboard backend, but you might not want all users to access it. You can restrict this access for certain user roles via Users > Settings > General > Misc Settings, with the 'Restrict Dashboard Access' setting: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5fe9d1af41fcb56e4047c3ca/file-FDFBmlmV71.png) --- # Emails Settings URL: https://wpusermanager.com/article/179-emails-settings/ Last updated: 2022-02-24 In your WordPress dashboard, navigate to "Users -> Settings -> Emails" to access the emails settings panel. The following settings screen allows you configure the email notifications on your website. WPUM sends up to two emails when a user registers and requests a new password, assuming you don't have any addons that send more. ### From Information You may set both the From Name and From Email address. They may be anything you'd like, but think carefully about how you want to represent your site via email, as well as what you want to happen when the end user hits the Reply button. ### Email Logo Upload a custom logo image that will be displayed above emails sent to your users. The logo will only appear when you're not using the plaintext email template. ### Visual Emails Editor WPUM comes with a handy emails editor that allows you to customize the content of each email sent by WPUM. To access the editor, in your WordPress dashboard, navigate to Users -> Emails. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/62179d25aca5bb2b753c60c9/file-Grm5NsIKVB.png) To edit an email, press the "customize" button into the list table. You will be redirected to a page where you can customize the subject and content of the email. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ef04286350aeeb533a/5d6cf2e88223d.png) The layout of the Message is created using the standard WordPress Rich Text editor. In addition to whatever text you'd like to write you have access to Template Tags. They look like this: {sitename} and they render bits of information about the account or your website. There's a complete list of available Template Tags right below the Rich Text Editor. ### Disable Emails Each email has a toggle that allows you to disable that email from being sent. Some emails, like the password recovery request email cannot be disabled. --- ### Disable Admin Notifications The last choice on the Email Settings page is an option to disable admin notifications altogether. When this is checked the only email that will be sent are the registration email to the user and a confirmation of a new password reset. You will not receive admin notifications when a user has signed up to your site or when a user has reset his password. --- # General Settings URL: https://wpusermanager.com/article/169-general-settings/ Last updated: 2026-10-15 In the WordPress admin, go to Users > Settings. The first tab, General, holds the settings below. They are grouped into three sections: the pages WP User Manager uses, Login Settings and Misc Settings. Pages Setup ----------- WPUM uses 5 pages for its frontend forms and profiles. It creates them when you install it, and you can change them here. Each one is a normal WordPress page with a shortcode on it, so to use a different page, add the shortcode to it and select it in the matching setting: - **Login Page:** the page with the \[wpum\_login\_form\] shortcode. - **Password Recovery Page:** the page with the \[wpum\_password\_recovery\] shortcode. - **Registration Page:** the page with the \[wpum\_register\] shortcode. - **Account Page:** the page with the \[wpum\_account\] shortcode. - **Profile Page:** the page with the \[wpum\_profile\] shortcode. --- Login Settings -------------- **Lock Access to wp-login.php:** stops visitors using the default wp-login.php page. They are redirected to the WPUM Login Page instead. See [Redirecting the WordPress login page](https://wpusermanager.com/article/217-redirecting-wordpress-login-page/). **Allow Users to Login With:** how users identify themselves on the login form. - Username only: users log in with their username. - Email only: users log in with their email address. - Username or Email Address: users can use either. New installs start with this one. **Prevent site access to visitors:** locks the whole site so only logged-in users can see it. Visitors who aren't logged in are redirected to the Login Page, and the REST API needs a logged-in user too. The Login Page and Password Recovery Page stay open. **Allow site registration:** shown once "Prevent site access to visitors" is on. It keeps the Registration Page open to visitors, so they can still sign up while the rest of the site is locked. If you have more than one registration page (with the [Registration Forms addon](https://wpusermanager.com/addons/registration-forms/)), add the others with the wpum\_registration\_pages filter: see [Preventing access to whole site unless a user is logged in](https://wpusermanager.com/article/301-preventing-access-to-whole-site-unless-a-user-is-logged-in/). To open any other page to visitors, use the wpum\_prevent\_entire\_site\_access\_allowed\_urls filter, which takes an array of full URLs. Each must match the requested URL exactly, including the trailing slash. **Generic Login Error:** shows the same error message whether the username or the password was wrong, so the login form can't be used to find out which usernames exist on your site. --- Misc Settings ------------- **Admin Bar:** hides the WordPress admin bar on the frontend for the user roles you select. Click into the field and pick one or more roles. **Restrict Dashboard Access:** stops the user roles you select from reaching the WordPress dashboard. Administrators always have access. See [Restricting Access to the WordPress Dashboard](https://wpusermanager.com/article/256-restricting-access-to-the-wordpress-dashboard/). **Excluded Usernames:** usernames your members can't register with. Put each one on a new line. **Roles Editor:** adds a Roles screen to the Users menu, where you can create roles and edit their capabilities. See [Editing WordPress User Roles and Capabilities](https://wpusermanager.com/article/271-editing-wordpress-user-roles-and-capabilities/). **Allow Multiple Roles:** lets you give a user more than one role. **Form Styles:** adds basic styles to the login, registration, account and password forms: full-width fields and a styled submit button. It's on by default for new sites. Turn it off if your theme already styles forms. --- # Profiles Settings URL: https://wpusermanager.com/article/153-profiles-settings/ Last updated: 2019-09-02 In your WordPress dashboard, navigate to "Users -> Settings -> Profiles" to access the profiles settings panel. The following settings screen allows you configure users profiles on your website. --- ### Profiles Restrictions **Allow guests to view profiles:** Enable this option to allow guests to view users profiles. **Allow members to view profiles:** Enable this option to allow members to view users profiles. If disabled, users can only see their own profile. --- ### Custom Avatars WPUM allows your users to upload custom avatars for their profiles. Uploaded avatars are stored on your server. Enable the option "Custom Avatars" to enable avatars upload for your users. ### Profile Permalinks To adjust the url structure of your users profiles, navigate to "Settings -> Permalinks -> User profiles permalink base" and select a structure among the 3 available. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2df04286350aeeb5315/5d6cf2d876440.png) Once selected, remember to save your changes. --- # Redirects Settings URL: https://wpusermanager.com/article/140-redirects-settings/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d604286350aeeb52fb/5d6cf2cfccaa4.png) In your WordPress dashboard, navigate to "Users -> Settings -> Redirects" to access the redirects settings panel. The following settings screen allows you configure redirects on your website. **Login redirect:** Select the page where you want to redirect users after they login. If empty will return to the current page. **Logout redirect:** Select the page where you want to redirect users after they logout. If empty will return to wp-login.php **Backend Register Redirect:** Select a page if you wish to redirect users who try to signup through the default registration page on wp-login.php **Backend Profile Redirect:** Select the page where you want to redirect users who try to access their profile on the backend. **Registration Redirect:** select a page if you wish to redirect users to a specific page after successful registration. **Backend lost password:** select a page if you wish to redirect users who try to recover they password through wp-login.php on your site. --- # Redirecting the WordPress login page URL: https://wpusermanager.com/article/217-redirecting-wordpress-login-page/ Last updated: 2026-09-27 WP User Manager adds a [login page that can be used on the front end](https://wpusermanager.com/tutorials/how-to-create-a-custom-login-page-for-wordpress-in-5-steps/) of a website, typically at /login. WordPress also has the wp-login.php page where admins can login to the site, however, you might want to restrict access to this page and redirect wp-login.php to your /login page. There is a setting in WP User Manager found by logging into your WordPress admin dashboard and navigating to Users > Settings > General > Login Settings. You can enable the 'Lock access to wp-login.php' setting and this will redirect the wp-login.php to the WPUM login page. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5de67e5104286364bc926ebf/file-edLPYpY5vy.png) --- # Registration Settings URL: https://wpusermanager.com/article/175-registration-settings/ Last updated: 2020-03-23 In your WordPress dashboard, navigate to "Users -> Registration Forms" then click 'Customize Form' for the default registration form (or any form if you have multiple registration forms using the [Registration Forms](https://wpusermanager.com/addons/registration-forms/) addon), then click the 'Settings' tab to access the registration settings panel. The following settings screen allows you configure the way registration process works on your website. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5e788eee04286364bc9713c9/file-qorMMEsvlM.png) **Login after registration:** if enabled, users are automatically logged in after registration. This option only works when custom passwords are enabled. --- ### Custom Role Selection WPUM allows you to let users decide their user role upon registration. If enabled, users can select a role through the registration form. **Allow role section**: enable this option to let users select a custom role upon registration. **Allowed Roles:** select one or more user roles that your visitors can select upon registration. Your visitors can only select 1 user role. --- ### Terms & Conditions **Enable terms & conditions:** if enabled, a checkbox will appear inside the registration form that your visitors must check in order to agree to your terms & conditions. **Terms Page:** select the page that contains your terms. This will be linked into your registration form. --- # How to Change the Privacy Policy URL: https://wpusermanager.com/article/325-how-to-change-the-privacy-policy/ Last updated: 2023-01-26 WordPress by default comes with a Privacy page that WP User Manager links to on the Registration form, with a checkbox for users to confirm they accept the policy. The Privacy Policy page can be edited in the WordPress admin via Settings > Privacy ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63d2ec431f7c4c45e9fbb476/file-okzIAVKZPj.png) You can change the page WordPress uses as the privacy policy page, and edit it's content. If you don't want a policy on your site you can edit edit the dropdown to '-Select-', or add this code to your site: https://gist.github.com/wp-user-manager/69c45c3d67fb7bf4de5106441035b5c2 --- # How to not generate a password for users created by other processes URL: https://wpusermanager.com/article/306-how-to-not-generate-a-password-for-users-created-by-other-processes/ Last updated: 2022-08-05 There are certain times that the registration is handled by other plugins, however WP User Manager automatically generates a password during registration. To deactivate this feature, you may download and save this file to your **/wp-content/mu-plugins/** directory (you might need to create the mu-plugins directory). - [wpum\_do\_not\_generate\_password.php](https://gist.github.com/wp-user-manager/7ac0a4266d6a08905081c009f2c04abe) add\_filter( 'wpum\_new\_user\_notification\_generate\_password', '\_\_return\_false' ); --- # How to stop registration email being sent for users created manually in the admin URL: https://wpusermanager.com/article/309-how-to-stop-registration-email-being-sent-for-users-created-manually-in-the-admin/ Last updated: 2022-08-07 WP User Manager sends an email to users after registration. However, this is also send for users that have been created from the backend and other registration processes and often the email is not needed. To stop it being sent, simply use the snippet in the link below by saving this file to your **/wp-content/mu-plugins/** directory (you might need to create the mu-plugins directory): https://gist.github.com/wp-user-manager/e1d2452fda1e17af1c055b7e2e7744b6 --- # How to allow other roles to edit custom fields in the admin dashboard URL: https://wpusermanager.com/article/305-how-to-allow-other-roles-to-edit-custom-fields-in-the-admin-dashboard/ Last updated: 2026-10-15 There are certain times when you would need to provide additional capabilities for the other roles on your site and as an example, you might need to let them edit the custom fields from the admin dashboard. This is possible with a few customization and utilization of the Role Editor feature of WPUM. First and foremost, enable the user role editor by following the guide from this link -[Editing WordPress User Roles and Capabilities]( https://wpusermanager.com/article/271-editing-wordpress-user-roles-and-capabilities/). Once this feature is enabled, proceed in Users >> Roles. Select the role you would like to grant access to edit custom fields from the admin's dashboard then click on the Edit Capabilities action. ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/6quzppgr/78aa67cd-baed-424d-840c-0f4b524f7507.jpeg?v=4c721dd396120356db9d9c5c02d88a61) Upon proceeding to the Edit Capabilities window, go to the "Users" capabilities tab and grant access to "create\_users" & "edit\_users" capabilities, then save the changes. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/62e25054a3bd513965054059/file-uIC36Fkf16.png) After doing so, you will need to add this snippet to your functions.php or a mu-plugin directory, to provide access to the "Custom Field" section. ``` add_filter( 'carbon_fields_user_meta_container_admin_only_access', '__return_false' ); ``` Feel free to [contact our support team](https://wpusermanager.com/support/) if you will need further assistance regarding this and we'll be glad to assist you with it. --- # Removing the nickname field from the profile, account and registration form URL: https://wpusermanager.com/article/304-removing-the-nickname-field-from-the-profile-account-and-registration-form/ Last updated: 2022-07-27 WP User Manager provides options to remove the nickname field from the profile, account, and registration form. It's a field WordPress has out of the box, but not many sites need it. To proceed in removing the nickname field, edit the Nickname custom field (Users > Custom Fields > Primary Fields > Nickname (edit). ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/X6uRLJ17/b87ee3a9-5cd7-4e79-ac13-bb595b9a2b66.jpeg?v=3c33b53ec8a4f6a87512b292b22c304a) From the ‘Privacy’ tab set it to hidden. Then in the ‘Permissions’ tab, you can set profile editing to hidden as well. Like so: ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/P8uQzj4P/e62fe2c0-5196-4de2-b5d3-9e709d644a04.jpeg?v=8df1f61bc6d88914eed52e086c704038) ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/qGuO8we6/9df60132-60ee-4c47-ad4d-ed21b3cf448c.jpeg?v=a190abf992fe1fcce6eec1e1f4c1208b) Make sure to save the settings to utilize the changes you made from here. We also have a separate guide to stop the nickname from appearing in the display name dropdown on the account, you can access it from this link– --- # I need to change my payment details for plugin renewals URL: https://wpusermanager.com/article/296-change-my-payment-details/ Last updated: 2021-09-24 I need to change my payment details for plugin renewals ======================================================= When you buy an addon or addon bundle, an annual subscription is created which will renew each year providing you with access to addon updates and support. If you paid by credit/debit card -------------------------------- If you paid by credit or debit card and need to change your payment details, then you can do this via your [Account page](https://wpusermanager.com/dashboard/). For example, you might have switched bank account or changed your debit or credit card. To do this, you need to [log in](https://wpusermanager.com/dashboard/)to your Account and go to the Subscriptions tab. You will then see an 'Update Payment Method' link which you can use to change your payment details. If you paid via PayPal ---------------------- To change the payment method in PayPal, you need to change the default payment method in your PayPal account. You don't need to change anything relating to our plugin as it will happen automatically after you remove the old payment method in PayPal. Can I change payment methods? ----------------------------- It's not possible to change your payment method, for example to switch from a PayPal subscription to credit or debit card payments. If you need to do this then we recommend that you cancel your existing subscription and re-purchase the plugin using your new payment method. I'm a developer - can I transfer the subscription to my client? --------------------------------------------------------------- If you're a developer and bought the plugin on behalf of a client, then you can transfer your account and subscription to them if you paid by credit card. This is more cost-effective for your client than cancelling your subscription and asking them to re-purchase the plugin in a year, because if you keep the subscription active then you "lock in" the current price and are protected from future price increases. This is how to transfer your plugin license to a client: 1. Log into your [Account](https://wpusermanager.com/dashboard/) and update all the personal information (including the email address) to use the client's details. 2. Give the the account login details to the client. 3. Ask the client to log into their account and use the instructions above to update the credit card information with their own. (Please note that the client will NOT have access to your credit card information from when you bought the plugin.) Note: If you have multiple email addresses in your account then you must remove the additional email addresses before you can change the primary address to the client. ### Can I transfer a PayPal subscription? Unfortunately if you paid via PayPal then you can transfer your account to the client, but not your ongoing subscription. The only option is to cancel the subscription and either ask your client to renew manually when the license key expires, or re-purchase the plugin under a new account. We recommend re-purchasing by the client, because this will set up a new annual subscription for the client, which will protect them against future price increases. --- # How to use Loco Translate for WP User Manager URL: https://wpusermanager.com/article/181-how-to-use-loco-translate-for-wp-user-manager/ Last updated: 2019-09-02 The following tutorial will teach you how to translate WP User Manager with the [Loco Translate plugin](https://wordpress.org/plugins/loco-translate/). [Loco Translate](https://wordpress.org/plugins/loco-translate/) is a WordPress plugin for translating themes and plugins. It generates and compiles language files on the fly so that they're compatible with your WordPress website. 1) Setup your language file --------------------------- Once you've installed the plugin, in your WordPress dashboard, navigate to "Loco Translate". Locate the "Running plugins" section and click on WP User Manager. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f02c7d3a7a4d77f587/5d6cf2e9e8cfb.png) A new page will appear showing details about the WP User Manager plugin. Now click on the "New language" button to create a new translation. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f12c7d3a7a4d77f588/5d6cf2ea5faa7.png) In the next screen, you need to select the language for which you need to create a translation. In order for your translation to work, your WordPress site language must be set up to the same language for which you're creating a translation. Your site's language can be selected under "Settings -> General -> Site language". For this tutorial we'll be using the "Italian" language as an example. When creating a new translation it's important that you set the location of the new language file to "System". Once you're done, click on the "Start translating" button. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f104286350aeeb533c/5d6cf2eaab993.png) 2) Translate the plugin ----------------------- Now that your translation has been set up, you can start translating the plugin. An editor window will appear from which you can select strings that you want to translate. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f104286350aeeb533d/5d6cf2eb22b26.png) After translating all the strings that you need to change, press the "Save" button and your translation will start working. --- # Understanding how login redirect works URL: https://wpusermanager.com/article/174-understanding-how-login-redirect-works/ Last updated: 2023-02-17 The WPUM login form supports multiple redirect methods. Here's an explanation of how each method works and is triggered. 1. **Query string method:** the login form will give priority to the **redirect\_to** query string into the browser url. When the query string is available, the login form will ignore any other method and redirect to the url specified into the query string. The query string obviously accepts an url that must be properly encoded. 2. **Selected page:** if both of the above condition is not available, and you have selected a page into [the admin panel](https://wpusermanager.com/article/140-redirects-settings/), the form will redirect to the selected page. This is usually triggered when someone goes straight to your login page without having visited any other page on your site. 3. If a query string and a selected page are not available, the login form will redirect to it's current page. --- # My emails aren't delivering URL: https://wpusermanager.com/article/154-my-emails-arent-delivering/ Last updated: 2019-09-02 WP User Manager relies on WordPress wp\_mail() php function to send all emails managed by the plugin. WordPress then, relies on your host to send emails. It is possible that your host is not properly configured to handle the PHP mail() function, therefore WordPress fails to send emails. Luckily there are many tutorials and alternative ways to send emails through WordPress. Many websites integrate third party services to send emails. One of these services is called [Mandrill](https://mandrill.com/). Mandrill provides up to 12,000 free email deliveries a month and it's much more reliable than the PHP mail() function. We suggest you read the following tutorials and articles in order to understand how to setup Mandrill on your WordPress website [Improve Your WordPress Email Delivery with Mandrill](https://narrowbridgemedia.com/wordpress-email-delivery-mandrill/) [How to Fix WordPress Not Sending Email Issue](http://www.wpbeginner.com/wp-tutorials/how-to-fix-wordpress-not-sending-email-issue/) --- # 404 Page Not Found Error URL: https://wpusermanager.com/article/143-404-page-not-found-error/ Last updated: 2019-09-02 This isn't an issue of the plugin. The problem involves your core WordPress installation, or your web server configuration. Possible solutions ------------------ Make sure you have properly configured all the pages required by the plugin - as explained into this documentation section Make sure you have properly configured your site's permalinks - read here In most cases the issue can be fixed by simply going in "Settings -> Permalinks" and re-save your permalink settings. The issue is usually caused by the activation/deactivation of a new theme/plugin on your site. --- ### Possible other causes - apache II mod\_rewrite module is not being loaded by your web server. - Your WordPress .htaccess file is missing or not writeable by the web server. - Apache II is configured to disallow overrides by your .htaccess file. ### Other solutions - First make sure that mod\_rewrite is installed and enabled on your Apache II web server, and also make sure that the webserver allows your .htaccess file to [override](http://httpd.apache.org/docs/2.2/mod/core.html#allowoverride) the server directory configuration. - Make sure that your WordPress .htaccess file is present in your WordPress installation. If it is not, simply create a blank file called .htaccess and upload it to your WordPress installation folder. - Set permissions on your .htaccess file that allows your web server to write to the file – CHMOD 666. - Go back and set your permalinks option to the “default” option and save the change. Then set it to something other than the default and save the change. - If your .htaccess file is writeable by the web server, it will contain new directives that sets rewrite rules for your custom permalink option. - If it is not writeable, you will see a message below your permalinks screen that contains the rule set you need to add manually into your .htaccess file, save it, and upload it back to the WordPress installation folder. - If the issue persists, contact your web host support team for further assistance. For additional information on working with permalinks in WordPress, visit the WordPress Codex [http://codex.wordpress.org/Using\_Permalinks](http://codex.wordpress.org/Using_Permalinks) --- # Handling database updates issues URL: https://wpusermanager.com/article/131-handling-database-updates-issues/ Last updated: 2019-09-02 WP User Manager is a complex plugin that extensively interfaces with your site’s database. From time to time, modifications to the database structure itself need to happen, whether to increase performance or to resolve issues. When that is the case, you will see a notice within the administration panel of your website asking you to upgrade the database. If you are experiencing troubles with the database update, in general, there are three types of issues that will conflict with the database updates: Caching, Security Plugins, and Admin-Ajax issues. ### Caching If you have any plugin or server side caching enabled, please flush the cache and temporarily disable the caching system. This resolves DB updates for a significant percentage of users. ### Security Plugins Security plugins ( like Wordfence ) many times will prevent changes to the database if they think these changes shouldn't happen. Temporarily disable any security plugin installed on the site and proceed with the database update. ### Admin-ajax issues If the admin-ajax.php file is blocked, database updates will not function. Please disable any security plugins and make sure your host has not restricted access to admin ajax. --- # How to update paid addons URL: https://wpusermanager.com/article/129-how-to-update-paid-addons/ Last updated: 2023-02-17 To enable support and automatic updates of paid addons, a valid license key must be provided. Upon purchase of an addon, a license key will be provided to you via email. You can also find the license key into [your account area of wpusermanager.com](https://wpusermanager.com/dashboard/). ### Enable your license Each paid addon/purchase comes with it's own license key. To enable updates, login to your WordPress dashboard where you've installed the addon and then go in "Settings -> WPUM Licenses" and enter the license for the addon that you have purchased. Press the save button and automatic updates will be available. Updates for addon work in the same way as regular WordPress plugins. When an update is available a notice will appear into your WP dashboard notifying you. --- # Translate WP User Manager URL: https://wpusermanager.com/article/125-translate-wp-user-manager/ Last updated: 2019-09-02 WPUM comes built in with translating capabilities to any language. WPUM is a [project on translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/wp-user-manager). We welcome you to [join the team of localizers](https://make.wordpress.org/polyglots/handbook/tools/glotpress-translate-wordpress-org/) and help translate WPUM to your language. Here's how to easily translate WPUM into other languages. You don't have to download any software, all translation is done online using the [GlotPress platform](https://make.wordpress.org/polyglots/handbook/tools/glotpress-translate-wordpress-org/). If WPUM has already been translated 100% to your language, we encourage you to still join the translation team, so you can help with translations in the next versions, or so you can improve the current translation. 1. Log in to WordPress.org -------------------------- Go to the [WordPress login page](https://login.wordpress.org/) and login to WordPress using your username and password. If you don't have an account yet, go ahead and create it, and on the way give us a 5-star rating :) 2. Enter the translation page ----------------------------- Now go to the [plugin translation page](https://translate.wordpress.org/projects/wp-plugins/wp-user-manager), and search for your language. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2cb2c7d3a7a4d77f530/5d6cf2c4dcc93.png) 3. Choose a string to translate ------------------------------- Choose a string you wish to translate. You can also methodically go over each string and translate the whole plugin, but this could take you a while. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2cb2c7d3a7a4d77f531/5d6cf2c537185.png) 4. Enter your translation and submit ------------------------------------ ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2cc04286350aeeb52eb/5d6cf2c587561.png) 4. Now what? ------------ All you have to do is send us a mail once you've finished translating to hello@wpusermanager.com and let us know about your translation, so we can get it approved by your language editors. The translation has to go through an approval process, so you can expect to see it after a few days. Go ahead and [translate WP User Manager now](https://translate.wordpress.org/projects/wp-plugins/wp-user-manager). You can learn more about joining the [translation team on GlotPress](https://make.wordpress.org/polyglots/handbook/tools/glotpress-translate-wordpress-org/). --- # How to set a minimum or maximum username length? URL: https://wpusermanager.com/article/110-how-to-set-a-minimum-or-maximum-username-length/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c32c7d3a7a4d77f51a/5d6cf2bd1b06f.png) - Download, install and activate the following addon - In your WP admin panel, navigate to **Users -> settings -> registration** and set the min and max length. --- # Is WP User Manager GDPR compliant? URL: https://wpusermanager.com/article/93-is-wp-user-manager-gdpr-compliant/ Last updated: 2020-01-23 The 25th of May 2018, new EU privacy rules have come into effect called the General Data Protection Regulation (GDPR). If you are an EU based business or your users are from the EU you will need to ensure that your site is compliant with the new regulations. For more information regarding GDPR please see: - - [WordPress 4.9.6 has been released](https://wordpress.org/news/2018/05/wordpress-4-9-6-privacy-and-maintenance-release/) with new tools that help website owners comply with the new regulations. WP User Manager now also provides new add-ons that help you comply with the new laws. **Please note that using WPUM and the mentioned add-ons does NOT guarantee compliance to GDPR**. WPUM gives you general information and tools, but is **NOT meant to serve as complete compliance package**. As the owner of your website, it **is your responsibility** to ensure that your site is compliant with the regulations. Please always contact an attorney for accurate information, we are not responsible for your website GDPR compliance and we can’t be held accountable for any legal issues. ### Asking for consent: When a privacy page is created and set up under "Settings -> Privacy" of your WordPress dashboard, WPUM will automatically add a checkbox to the registration form asking the user for consent. ### Right of the user to access and delete his data: WP User Manager provides a an [add-on](https://wpusermanager.com/addons/personal-data/) for this specific purpose Account cancellation: Other than the ability for an administrator to delete a user's account, WPUM provides a an [add-on](https://wpusermanager.com/addons/delete-account/) that allows members to delete their own account from the front-end. --- # WordPress menu manager URL: https://wpusermanager.com/article/89-wordpress-menu-manager/ Last updated: 2019-09-02 WP User Manager extends the way your WordPress menu manager works. We have added a set of WPUM powered links directly into the menu manager interface. These are dynamic links that hide and display based on different conditions. Setting menu items visibility ----------------------------- You can set a visibility option for each menu item in your menu. The following are the available visibility options: - Show menu item to everyone. - Show menu item to logged in users only ( with possibility to select user roles too ). - Show menu item to logged out users only. When editing a menu item you will now see a new "Display to" setting, select the option that you prefer and then save your menu. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cef9c2c7d3a7a4d77f4d8/5d6cef9617c8b.png) Creating a logout link ---------------------- In order to create a logout link, create a menu item and then enable the **"set as logout url"** option. --- # How to find a user ID number URL: https://wpusermanager.com/article/196-how-to-find-a-user-id-number/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f92c7d3a7a4d77f59b/5d6cf2f33f091.png) 1 Navigate to "Users -> All Users" in your WordPress dashboard 2 Search for a registered user 3 Finally, locate the ID number on the right side of the screen under the "User ID" column --- # Does WPUM work with any theme? URL: https://wpusermanager.com/article/186-does-wpum-work-with-any-theme/ Last updated: 2019-09-02 WP User Manager has been designed and coded to seamlessly integrate with any properly coded WordPress theme. However, each theme is coded differently and the quality of the code can vary. This means that we cannot guarantee that the plugin works with all themes. To avoid potential issues and conflicts, WPUM adds very little css and js to your website. If your theme is properly coded, WPUM should adapt itself to your site layout. --- # Do you automatically add pages to my menu? URL: https://wpusermanager.com/article/195-do-you-automatically-add-pages-to-my-menu/ Last updated: 2019-09-02 WP User Manager only creates new pages upon activation of the plugin. These pages are required for the correct functionality of the plugin. **WPUM does NOT add any of it's pages to your site's menus.** --- # I can't see profiles I always see my own profiles URL: https://wpusermanager.com/article/128-i-cant-see-profiles-i-always-see-my-own-profiles/ Last updated: 2019-09-02 The issue is most likely caused by a plugin on your site. Please disable all the plugins installed on your site and then re-save your permalink settings. If now you're able to view profiles, it means that one of the plugins that you had previously activated on your site was causing the issue. --- # Permalinks & User Profiles URL: https://wpusermanager.com/article/139-permalinks-user-profiles/ Last updated: 2023-02-18 User profiles will work once specific permalink settings are enabled. This tutorial assumes you have already created the profiles page as [explained here](https://wpusermanager.com/article/194-profiles-page-setup/). Site Permalinks --------------- Your website cannot use the default permalink structure. You must change your permalink structure to anything else other than the default one. To change your permalinks go in "Settings -> Permalinks" in your WordPress dashboard, and set the structure to "post name". ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d52c7d3a7a4d77f54e/5d6cf2ceee37e.png) Profiles Permalinks ------------------- To adjust the profiles permalinks, scroll down when viewing the "permalinks settings page", and locate the "User profiles permalink base" section. Select one of the structures as displayed into the screenshot here: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d52c7d3a7a4d77f54f/5d6cf2cf3eb83.png) Then press the "save changes" button. --- # Before updating URL: https://wpusermanager.com/article/188-before-updating/ Last updated: 2019-09-02 Before updating plugins a production server you should make a backup of your entire site. There are a wide variety of options here. You could simply grab a backup of your database and FTP your files to a backup location. A better option is to use a backup plugin or service. These make it much easier and faster to make a backup, which makes it much more likely that you'll actually do it. #### Free Options [WordPress.org has many many backup plugins available](https://wordpress.org/plugins/search.php?q=backup). They have a variety of options and tools, feel free to experiment and find one that fits you. #### Paid Options [BackupBuddy](https://ithemes.com/purchase/backupbuddy/) is a plugin with an optional storage service that has a great many options and comes with paid support. [VaultPress](https://vaultpress.com/) is both a plugin and a storage service and is owned by Automattic. Regardless of method, please be sure to always make a backup of your entire site before updating any plugins. --- # Updating WPUM manually via FTP URL: https://wpusermanager.com/article/162-updating-wpum-manually-via-ftp/ Last updated: 2023-02-17 This process is very, very similar to installing via FTP. The only real difference is that the **wp-user-manager** folder will already exist. First, visit the following page to download the most recent version of WP User Manager: Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wp-user-manager. This is where things differ from the install. Now you want to take the CONTENTS of the **wp-user-manager** folder, and put them inside the **wp-user-manager** folder that exists on the server. Now go to the Plugins page in your WordPress admin area, find WP User Manager and deactivate and immediately reactivate it. This allows its install hooks to fire and check for database updates etc. Then you're finished. --- # Installing from WordPress.org URL: https://wpusermanager.com/article/151-installing-from-wordpressorg/ Last updated: 2019-09-02 Installing WP User Manager is just like any other WordPress plugin. Navigate to your WordPress “Plugins” page, inside of your WordPress dashboard, and follow these instructions: 1. In the search field enter “WP User Manager”. Click “Search Plugins”, or hit Enter. 2. Select "WP User Manager" and click either “Details” or “Install Now”. 3. Once installed, click “Activate”. WP User Manager is now activated and ready to be configured. --- # Updating WPUM from WordPress.org URL: https://wpusermanager.com/article/126-updating-wpum-from-wordpressorg/ Last updated: 2019-09-02 When an update for WP User Manager, you will see a notification in your WordPress dashboard. Usually you will also see a number next to the "Plugins" section into your WordPress Dashboard indicating the amount of plugins that need to be updated. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2cc04286350aeeb52ec/5d6cf2c62a6eb.png) Navigate to the "Plugins" page into your WordPress dashboard and locate the WP User Manager plugin. If an update is available, the WPUM section will turn pale orange, and have a red bar on the left edge **with a link to update the plugin**. Once you click it, a small updating spinner will appear, and then it will say "Updated!". Then your update is finished. --- # Installing Manually via FTP URL: https://wpusermanager.com/article/109-installing-manually-via-ftp/ Last updated: 2023-02-17 To install WP User Manager via FTP - please download it from here first: . This will download a zipped package to your computer. Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called **wp-user-manager.** Use your favorite file transfer tool (e.g Filezilla) to copy that **FOLDER** (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WP User Manager in the plugin list. Click the Activate link and you'll be ready to use the plugin. --- # Profiles Page Setup URL: https://wpusermanager.com/article/194-profiles-page-setup/ Last updated: 2023-02-18 The WP User Manager requires a profiles page. **The page will be created on installation of the plugin. However, if it is deleted or you need to set it up again, follow these instructions.** This page should contain the [profiles page shortcode](https://wpusermanager.com/article/173-pages-shortcodes/). This page is required by WPUM and it's used across your site and linked when necessary. The profiles page is the page where your members will be able to see their own public profile and other members profiles. ### How to create this page 1 Navigate to "Pages -> add new" into your WordPress dashboard. 2 Create a new page and give it a title. 3 Add the [profiles page shortcode](https://wpusermanager.com/article/173-pages-shortcodes/) to the page content. 4 Save the page 5 Navigate to "Users -> Settings" into your WP dashboard 6 Select the page you have just created into the option called "profile page" --- # Account Page Setup URL: https://wpusermanager.com/article/177-account-page-setup/ Last updated: 2023-02-18 The WP User Manager requires an account page. **The page will be created on installation of the plugin. However, if it is deleted or you need to set it up again, follow these instructions.** This page should contain the [account page shortcode](https://wpusermanager.com/article/173-pages-shortcodes/). This page is required by WPUM and it's used across your site and linked when necessary. The account page, is the page where your users will be able to edit their profiles, change their information and also change their password. ### How to create this page 1 Navigate to "Pages -> add new" into your WordPress dashboard. 2 Create a new page and give it a title. 3 Add the [account page shortcode](https://wpusermanager.com/article/173-pages-shortcodes/) to the page content. 4 Save the page 5 Navigate to "Users -> Settings" into your WP dashboard 6 Select the page you have just created into the option called "Account page" --- # Login Page Setup URL: https://wpusermanager.com/article/176-login-page-setup/ Last updated: 2026-09-27 The WP User Manager requires a [login page](https://wpusermanager.com/tutorials/how-to-create-a-custom-login-page-for-wordpress-in-5-steps/). **The page will be created on installation of the plugin. However, if it is deleted or you need to set it up again, follow these instructions.** This page should contain the [login form shortcode](https://wpusermanager.com/article/170-login-form-shortcode/). This page is required by WPUM and it's used across your site and linked when necessary. ### How to create this page 1 Navigate to "Pages -> add new" into your WordPress dashboard. 2 Create a new page and give it a title. 3 Add the [login form shortcode](https://wpusermanager.com/article/170-login-form-shortcode/) to the page content. 4 Save the page 5 Navigate to "Users -> Settings" into your WP dashboard 6 Select the login page you have just created into the option called "login page" --- # Registration Page Setup URL: https://wpusermanager.com/article/155-registration-page-setup/ Last updated: 2023-02-18 The WP User Manager requires a registration page. **The page will be created on installation of the plugin. However, if it is deleted or you need to set it up again, follow these instructions.** You can use the new WPUM Registration Form block. To do so, please follow the steps below: 1.) Navigate to "Pages -> add new" into your WordPress dashboard. 2.) Create a new page and give it a title. 3.) Add the WPUM Registration Form Block ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/KounjXXW/b311b9ae-cb67-4a3a-b172-800a2c5e5850.jpeg?v=649d468e9d183f9808d57c621e4c31a8) 4.) Save the page 5.) Navigate to "Users -> Settings" into your WP dashboard 6.) Select the registration page you have just created into the option called "Registration page" Alternatively, if you are still using the native WordPress editor, the page should contain the [registration form shortcode](https://wpusermanager.com/article/141-registration-form-shortcode/). This page is required by WPUM and it's used across your site and linked when necessary. ### How to create this page 1 Navigate to "Pages -> add new" into your WordPress dashboard. 2 Create a new page and give it a title. 3 Add the [registration form shortcode](https://wpusermanager.com/article/141-registration-form-shortcode/) to the page content. 4 Save the page 5 Navigate to "Users -> Settings" into your WP dashboard 6 Select the registration page you have just created into the option called "Registration page" --- # Password Recovery Page Setup URL: https://wpusermanager.com/article/90-password-recovery-page-setup/ Last updated: 2023-02-18 The WP User Manager requires a password recovery page. **The page will be created on installation of the plugin. However, if it is deleted or you need to set it up again, follow these instructions.** This page should contain the [password recovery form shortcode](https://wpusermanager.com/article/158-password-recovery-form-shortcode/). This page is required by WPUM and it's used across your site and linked when necessary. Furthermore this page is essential when a user on your website might have forgotten their password and needs to reset/recovery it. ### How to create this page 1 Navigate to "Pages -> add new" into your WordPress dashboard. 2 Create a new page and give it a title. 3 Add the [password recovery form shortcode](https://wpusermanager.com/article/158-password-recovery-form-shortcode/) to the page content. 4 Save the page 5 Navigate to "Users -> Settings" into your WP dashboard 6 Select the page you have just created into the option called "password recovery page" --- # Controlling Profile Privacy URL: https://wpusermanager.com/article/266-controlling-profile-privacy/ Last updated: 2021-01-23 User profiles are of course visible to that user, but you can control who else sees the profiles. In the Users > Settings > Profiles settings you can use the following settings to control privacy for all profiles: - 'Allow Guests to View Profiles' - Enable this option to allow guests to view users profiles. - 'Allow Members to View Profiles' - Enable this option to allow members to view users profiles. If disabled, users can only see their own profile. You can also turn on the 'Allow Members to set their profile privacy' setting to allow users to control their own profile privacy, which overrides the global settings. (Available in WP User Manager v2.5 and greater) When enabled, users see a new tab on their account page, where they can set to hide their profile from guests and/or other members: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bf9ac1c64ad47e4b723ae/file-Ial2rNuOnV.png) These settings are also available in the WordPress admin area when editing a user, so admins can hide specific user profiles. - Log in to the WordPress admin - Navigated to Users > All Users - Find the user and click 'Edit' - Scroll down to the 'Profile Privacy' section ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bfa331c64ad47e4b723af/file-zTcVb7Fxms.png) --- # Add fields to the registration form URL: https://wpusermanager.com/article/187-add-fields-to-the-registration-form/ Last updated: 2019-09-02 Certain fields can be displayed into the registration form. Not all fields can be added to registration forms, and specific fields (e.g email) will always need to be displayed. In your dashboard, navigate to **Users -> Registration forms** and click the "Customize fields" link within the forms. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f404286350aeeb5344/5d6cf2edd78fd.png) A new page will load with a drag and drop editor for the fields. To add fields to a form, drag them from the left side, and drop them into the allocated area on the right side of the screen. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f52c7d3a7a4d77f592/5d6cf2ee3d67b.png) Each form can also have a specific user role assigned. The assigned role, will then be given to the user that registers through that specific form. --- # Introduction to the fields editor URL: https://wpusermanager.com/article/171-introduction-to-the-fields-editor/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c404286350aeeb52dc/5d6cf2be16c94.png) The WPUM Fields editor allows you to customize the profile fields on your website. To access the fields editor navigate to "Users -> Custom Fields". The editor allows you to customize the names and descriptions of the fields, the order in which they are displayed into the profile pages and account forms and various other settings like privacy and editing functionalities. **Adding custom fields is possible through the** [**custom fields addon.**](https://wpusermanager.com/addons/custom-fields/) --- # Setting fields as required URL: https://wpusermanager.com/article/142-setting-fields-as-required/ Last updated: 2019-09-27 Certain fields can be set as required during the registration or profile editing process. Not all fields can be changed, and specific fields (e.g email) will always be required. In order to set a field as required, navigate to Users > Custom fields then click "Customize fields" for the field group which contains the fields you want to edit. This is usually the 'Primary fields' group for the default fields, eg. First name, Last name. Click the "Edit field" button of the field you wish to customize. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d72c7d3a7a4d77f553/5d6cf2d125a8a.png) A new window will appear with all the settings related to that field. On the left side of the modal window you will see the "Validation" menu. Click on the tab to display the validation settings. Click on the " **Set as required**" option to set the field as required. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d804286350aeeb52ff/5d6cf2d160ef7.png) Once you have finished, click the "Save field" button to confirm your changes. --- # Field Groups URL: https://wpusermanager.com/article/127-field-groups/ Last updated: 2023-02-18 WP User Manager, upon activation creates a "Primary" Field group. This group manages the fields available by default with WordPress. On profile pages, fields are arranged and separated by groups. Creating new fields groups will also create a separate tab within the account page containing a form with the fields assigned to that specific group. Creating new field groups ------------------------- Refer to the custom fields addon documentation, to add new fields groups Customizing a field group Each group can have it's name and description. The name is displayed within the profile page and also within the account page. The description may be displayed depending on your theme. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2cd2c7d3a7a4d77f536/5d6cf2c6bbd28.png) The "group settings" window provides you 2 options to customize the name and description of each group. Once you're done with the customization, press the "Save changes" button to save your changes. --- # How to hide fields on the profile page URL: https://wpusermanager.com/article/219-how-to-hide-fields-on-the-profile-page/ Last updated: 2020-01-03 Sometimes you want certain profile information hidden on the public profile page for users, for example their email address. To do this, you need to navigate to Users > Custom Fields > Customize the fields (of the field group) -> Edit field (of the field you want to hide). Then, on the Privacy tab select 'Hidden' under the Profile visibility setting. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5e0f434004286364bc936d47/file-JlSaVMdkkN.png) --- # Change the order of the fields URL: https://wpusermanager.com/article/112-change-the-order-of-the-fields/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c404286350aeeb52dc/5d6cf2be16c94.png) To change the order of the fields, click and drag the following![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c52c7d3a7a4d77f51c/5d6cf2be75686.png) button to change the order of the fields. Once you have changed the order, a success message will appear on top of the page. --- # Content Restrictions Shortcodes URL: https://wpusermanager.com/article/180-content-restrictions-shortcodes/ Last updated: 2026-10-01 The [content restriction shortcodes](https://wpusermanager.com/tutorials/how-to-implement-gated-content-for-your-wordpress-website/) allow you to restrict access to content on your website pages/posts. The content can be restricted as a whole or you can also restrict parts of your content. To restrict content on your site, open up the shortcodes editor and select one of the options from the "Restrictions" menu. A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. ### Restrict to logged in users only This shortcode is extremely easy to use and requires no further configuration. To hide your content simply wrap your content within the shortcode. **Example usage:** ``` [wpum_restrict_logged_in] add the content you wish to restrict here [/wpum_restrict_logged_in] ``` ### Restrict to specific users only This shortcode allows you to restrict content to specific users only. It means that only the users specified will have access to the content. Example usage ``` [wpum_restrict_to_users ids="1, 55, 80"] content here [/wpum_restrict_to_users] ``` Separate each user id with a comma like in the screenshot here: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ef2c7d3a7a4d77f585/5d6cf2e933f66.png) ### Restrict specific user roles only This shortcode allows you to restrict content to specific user roles only. It means that only the specified user roles will have access to the content. ``` [wpum_restrict_to_user_roles roles="subscriber, administrator"] content here [/wpum_restrict_to_user_roles] ``` Note: the roles parameter above accepts only user roles names NOT the titles. Here's a list of the default user roles names ( NOT TITLES ) that come with WordPress - administrator - editor - author - contributor - subscriber ### Restrict to specific user groups only This shortcode allows you to restrict content to users who are members of specific user groups only. It means that only the users specified will have access to the content. Example usage: ``` [wpum_restrict_to_user_groups groups="95"] content here [/wpum_restrict_to_user_groups] ``` Separate each user group id with a comma like in the screenshot here. This shortcode is only available with the [Groups addon](https://wpusermanager.com/addons/groups/). --- # Registration Form Widget URL: https://wpusermanager.com/article/178-registration-form-widget/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ee04286350aeeb5337/5d6cf2e786b3f.png) WPUM Widgets can be added anywhere into your site's widgets area ( assuming your theme supports widgetized areas ). The widget can be configured in a few different ways. - You can hide/show different links below the form such as password recovery and login link - For developers, you can also add an ID to the markup of the form for further customizations --- # Pages Shortcodes URL: https://wpusermanager.com/article/173-pages-shortcodes/ Last updated: 2021-03-23 These pages are required for the correct functionality of the plugin. It is important that you create a separate page for each core page. Account Page: ------------- The account page, is the page where your users will be able to edit their profiles, change their information and also change their password. **Shortcode usage:** ``` [wpum_account] ``` ### Profiles Page The profiles page is the page where your members will be able to see their own public profile and other members profiles. **Shortcode usage:** ``` [wpum_profile] ``` --- # Login Form Shortcode URL: https://wpusermanager.com/article/170-login-form-shortcode/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ea04286350aeeb532c/5d6cf2e3efda2.png) To insert a login form into pages or posts on your WordPress website, open up the shortcodes editor and select "Login Form" from the "Forms" menu. A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | | | | psw\_link | Specify if you wish to display a link to the password recovery page ( selected into the WPUM Settings panel ) | | register\_link | Specify if you wish to display a link to the registration page ( selected into the WPUM Settings panel ) | **Example Usage:** ``` [wpum_login_form psw_link="yes" register_link="yes" ] ``` --- # Password Recovery Form Shortcode URL: https://wpusermanager.com/article/158-password-recovery-form-shortcode/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e12c7d3a7a4d77f566/5d6cf2da956f5.png) To insert a password recovery form into pages or posts on your WordPress website, open up the shortcodes editor and select "Password Recovery Form". A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | login\_link | Specify if you wish to display a link to a login page ( page selected into the WPUM settings panel ) | | register\_link | Specify if you wish to display a link to the registration page ( selected into the WPUM Settings panel ) | Example Usage: ``` [wpum_password_recovery login_link="yes" register_link="yes" ] ``` --- # Reset Password Widget URL: https://wpusermanager.com/article/157-reset-password-widget/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e02c7d3a7a4d77f564/5d6cf2da0ea6e.png) The password recovery form widget allows you to add a form into a widgetized area of your theme that allows your visitors to reset their password if they have forgotten it. The widget will send an email to the user with a link to your password recovery page previously set up. The widget can be configured in a few different ways. - You can hide/show different links below the form such as login and registration link - For developers, you can also add an ID to the markup of the form for further customizations --- # Login Link Shortcode URL: https://wpusermanager.com/article/156-login-link-shortcode/ Last updated: 2019-09-02 To insert a login link into pages or posts on your WordPress website, open up the shortcodes editor and select "Login link" from the list. A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | redirect | Optional parameter, specify a custom redirect url or leave blank to use the page selected into the WPUM settings panel | | label | Specify the label of the link | ``` [wpum_login redirect="" label="Login" ] ``` --- # Recently Registered Users URL: https://wpusermanager.com/article/152-recently-registered-users/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2de04286350aeeb5313/5d6cf2d7c81c3.png) To insert a list of the recently registered users into pages or posts on your WordPress website, open up the shortcodes editor and select "Recently registered users". A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | amount | Numeric amount of how many users you wish to display into the list | | link\_to\_profile | Specify if you wish to display link the name of your users to their individual profile page | **Example usage** ``` [wpum_recently_registered amount="10" link_to_profile ="yes" ] ``` --- # Registration Form Shortcode URL: https://wpusermanager.com/article/141-registration-form-shortcode/ Last updated: 2020-01-13 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d704286350aeeb52fd/5d6cf2d0872f2.png) To insert a registration form into pages or posts on your WordPress website, open up the shortcodes editor and select "Registration Form" from the "Forms" menu. A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | login\_link | Specify if you wish to display a link to a login page ( page selected into the WPUM settings panel ) | | psw\_link | Specify if you wish to display a link to the password recovery page ( selected into the WPUM Settings panel ) | Example Usage: `[wpum_register psw_link="yes" login_link="yes" ]` --- # Logout Link Shortcode URL: https://wpusermanager.com/article/111-logout-link-shortcode/ Last updated: 2019-09-02 To insert a logout link into pages or posts on your WordPress website, open up the shortcodes editor and select "Logout link" from the list. A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | redirect | Optional parameter, specify a custom logout url or leave blank to use the page selected into the WPUM settings panel | | label | Specify the label of the link | Example usage: ``` [wpum_logout redirect="" label="Logout" ] ``` --- # Login Form Widget URL: https://wpusermanager.com/article/108-login-form-widget/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c22c7d3a7a4d77f519/5d6cf2bc22faa.png) WPUM Widgets can be added anywhere into your site's widgets area ( assuming your theme supports widgetized areas ). The login form widget can display: - Login form when the user is not logged in. - Profile overview (if enabled) when the user is logged in. The widget will automatically change it's title and content once the user is logged in. Furthermore if enabled, you can also display links to password recovery and registration pages. --- # Profile Card Shortcode URL: https://wpusermanager.com/article/88-profile-card-shortcode/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cef9c2c7d3a7a4d77f4d6/5d6cef95575ef.png) To insert a profile card of a user into pages or posts on your WordPress website, open up the shortcodes editor and select "Profile Card". A window ( displayed into the screenshot above ) will appear, displaying all the available parameters. It is recommended that you always use the shortcodes editor to add shortcodes to your pages/posts. In this way you're sure your shortcode has been added with the correct parameters configuration. | Parameter | Usage | |---|---| | user\_id | The ID number of a user on your website | | link\_to\_profile | Specify if you wish to link the card to the individual user profile page | | display\_buttons | Specify if you wish to display the "view profile" and "send email" button into the card | Example usage: ``` [wpum_profile_card user_id="1" link_to_profile ="yes" display_buttons ="yes" ] ``` --- # Introduction to the shortcodes editor URL: https://wpusermanager.com/article/172-introduction-to-the-shortcodes-editor/ Last updated: 2019-09-02 WP User Manager comes with a handy shortcodes editor. The editor is embedded into your WordPress pages and posts visual editor. To open the shortcodes editor, click the WPUM logo icon. Once clicked, a menu will appear with a list of all the available shortcodes. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2eb2c7d3a7a4d77f57d/5d6cf2e526cf4.png) --- # Recently registered users widget URL: https://wpusermanager.com/article/189-recently-registered-users-widget/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f604286350aeeb5348/5d6cf2ef73d01.png) Use the recent users widget to display a list of recently registered users on your website. You can configure the amount of users you wish to display and wether or not to link to their individual profile page. --- # Collecting Payment on Registration URL: https://wpusermanager.com/article/340-collecting-payment-on-registration/ Last updated: 2023-03-13 Once you have connected your Stripe account to WP User Manager, you can start accepting payments for site registration using credit cards. Here are the steps to follow: 1. In your WordPress admin, navigate to the Users > Registration Forms menu item 2. Select the registration form (you can create multiple forms with the [Registration Forms addon](https://wpusermanager.com/addons/registration-forms/)) that you want to add the payment option to and click on the "Edit" link. 3. Select the "Payment" tab 4. Use the 'Stripe Product' dropdown to select the product or products to use at registration. 5. If you only select one product, the registration form will use this during the registration process 6. If you select more than one product, the user will be able to select from them during registration. 7. Save the changes to the registration form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640df154c79fa516eb248512/file-nq20bsQuwG.png) The registration form with one product selected will look like this - ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640df227c79fa516eb248513/file-SwxZJez0fn.png) The registration form with multiple products to choose from will look like - ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640df2a53387cb3e147b76bb/file-4S64euNOel.png) After the user has filled out the form and clicked 'Register' they will be taken to a Stripe hosted checkout form, and the once payment is made they will be redirected back to the site. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640f7a8d67d5242b940eee68/file-Uot8tpvvoX.png) --- # Recurring Subscriptions URL: https://wpusermanager.com/article/337-recurring-subscriptions/ Last updated: 2023-03-13 WP User Manager connects to Stripe to listen to subscription events, so it knows when users have paid for a subscription based product, upgraded, downgraded or cancelled and can restrict content accordingly. If you are looking to charge a recurring fee for access to your site (eg. annual membership), then you would need to create recurring products in Stripe. Then you would need to configure the Billing Portal in Stripe. This allows customers to use Stripe's hosted billing page to upgrade, downgrade and cancel their subscription. 1. In Stripe, navigate to the [Customer Portal settings](https://dashboard.stripe.com/settings/billing/portal). 2. Configure the Invoice settings you want 3. Configure the Customer settings 4. Configure the Subscription settings 1. Allow users to cancel plans 2. Allow users to switch plans 3. Select your eligible products (see below) 5. Configure your Business Information Configure Eligible Products --------------------------- ### In Stripe If your Stripe account contains multiple products, you may not want users to be able to upgrade or downgrade to all of them. In the Subscription settings in Stripe, you need to choose all the eligible products: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640ef12ec79fa516eb24856b/file-b3PWZL9nNJ.png) ### In WP User Manager In Users > Settings > Stripe you need to also select the same products in the 'Eligible Products' dropdown. This will ensure only those products are shown on the Account Billing page. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640ef19fcde2720700022a22/file-5vmQQKsHSY.png) Invoices -------- Once a user has paid for a recurring product, they will be able to access their invoices from the Billing Account page and be able to download them as PDFs. --- # Creating Products URL: https://wpusermanager.com/article/339-creating-products/ Last updated: 2023-03-13 Before you can get users to register and pay for access to your site, you need to create products in Stripe to the plans available. 1. In Stripe navigate to the 'Products' screen - 2. Click 'Add Product' 3. Give your product a title and description if needed 4. Select 'Standard' Pricing Model 5. Add your price and currency 6. For recurring subscriptions, select 'Recurring' 1. Then select your billing period, eg. Yearly, Monthly 7. For one-off payments select 'One time' 8. Repeat for different prices for the product or create another product ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640eeedc3387cb3e147b770c/file-R3sgEV2tf4.png) --- # Restricting Site Access URL: https://wpusermanager.com/article/338-restricting-site-access/ Last updated: 2023-03-13 By default a user who has purchased a product or subscription during the registration process will get access to the site. If a user doesn't complete the Stripe checkout process they will be redirected to the Billing page on their Account when they next log in. They will not be able to access other parts of the site until they have purchased. They can purchase a product from the Billing page: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640eed3bdc01bb231eb3c305/file-s6vJBcmcXQ.png) Restricting Content to Specific Products ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- If you site has multiple products people can register with, but you want to restrict certain content (posts, pages, custom post types) to be only visible to user who have purchase a specific product, like a higher priced product, you can do this with the [Content Restriction addon](https://wpusermanager.com/addons/content-restriction/): ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640eeddcdc01bb231eb3c308/file-oLoStT8hEr.png) --- # Using Stripe to Collect Payment for Site Registration URL: https://wpusermanager.com/article/333-using-stripe-to-collect-payment-for-site-registration/ Last updated: 2023-03-13 [WP User Manager](https://wpusermanager.com/) is a powerful WordPress plugin that offers users a range of features to manage their profiles on a website. In version 2.9 we added the ability to connect a Stripe account to the site to accept payment for site registration using credit cards. In this article, we will explain how to set up and use this feature. ### Pricing WP User Manager offers two pricing options for using Stripe payment gateway. 1. Pay as you go: the Stripe integration is included in the free the WP User Manager plugin, there is a 2% fee on top of the standard Stripe fees for each transaction. 2. [Stripe Pro addon](https://wpusermanager.com/addons/stripe-pro/): WP User Manager also offers a Stripe Pro addon, which is available with the [Pro bundle and higher](https://wpusermanager.com/pricing/). With this addon, users can remove the WP User Manager fees and only pay the standard Stripe fees. Getting Started --------------- ### Connecting Your Stripe Account The first step in using the Stripe payment feature is to connect your Stripe account to the WP User Manager plugin. Here are the steps to follow: 1. Log in to your WordPress website and navigate to the WP User Manager settings page. 2. Click on the "Stripe" tab 3. Select your mode for connecting to Stripe, either in Test or Live mode. You can use Test mode when testing out on a development/staging copy of the site. 4. Click on the "Connect with Stripe" button and follow the prompts to connect your Stripe account. 5. Your site needs to listen and respond to events that happen in your Stripe account with a webhook. [Learn how to create the webhook](https://wpusermanager.com/article/334-setting-up-the-stripe-webhook/). ### Next Steps Now you can get started collecting payments for access to your site. - [Creating Products in Stripe](https://wpusermanager.com/article/339-creating-products/) - [Collecting Payment at Registration](https://wpusermanager.com/article/340-collecting-payment-on-registration/) - [Restricting Site Access](https://wpusermanager.com/article/338-restricting-site-access/) - [Recurring Subscriptions](https://wpusermanager.com/article/337-recurring-subscriptions/) --- # Setting up the Stripe Webhook URL: https://wpusermanager.com/article/334-setting-up-the-stripe-webhook/ Last updated: 2023-03-12 To set up you webhook in Stripe visit the [Webhook setting page in Stripe](https://dashboard.stripe.com/webhooks) [![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640ded4b3387cb3e147b76b8/file-PuDJp4LLnE.png)](https://dashboard.stripe.com/webhooks) Click 'Add an endpoint' then - 1. Add your endpoint URL from your site settings, which will be in the format - 2. Select 'Events on your account' 3. Select all events. 4. Click 'Add endpoint' 5. Under the endpoint 'Signing Secret', click reveal then copy and paste the secret into the setting on the WP User Manager Stripe settings page. 6. Click 'Save Changes' ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640def3dc79fa516eb248511/file-uNxaRxIALu.png) Once you have successfully connected your Stripe account and set up your webhook, you can begin accepting payments for site registration. Note: if you want to test the Stripe integration on a local development site, Stripe will not be able to access your site for the endpoint so you would need to use a service like [ngrok](https://ngrok.com/) to create an accessible URL to use in the Stripe webhook. --- # Registrations are currently disabled URL: https://wpusermanager.com/article/328-registrations-are-currently-disabled/ Last updated: 2023-02-03 If you are seeing the "Registrations are currently disabled." error message on the 'Register' page, then you need to allow user registrations in the WordPress site settings. This can be enabled in Settings > General by checking the 'Membership' checkbox: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63dd9657d4571976c49de359/file-a9bnGclpGf.png) --- # Directory General Settings URL: https://wpusermanager.com/article/190-directory-general-settings/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f604286350aeeb534a/5d6cf2f00480a.png) When creating or editing a directory, the "General Settings" panel contains settings that allow you to specify the grouping criteria for your directory. ### User Roles: This option allows you to specify which user roles will be displayed into your directory. Click into the "user roles" input field and a list of user roles on your website will appear. If left blank, the directory will display all users from all your user roles. From the list you can select as many roles as you want. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f704286350aeeb534b/5d6cf2f06c2c1.png) --- ### Excluding specific user If you wish to exclude specific users from appearing into a directory, you specify the user ID(s) number(s) into the "Exclude Users" setting. To find the ID number of a user registered on your site, navigate to "Users -> all users". In this screen a new column has been added by WPUM which displays the ID number of the user. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f704286350aeeb534c/5d6cf2f0b884b.png) Now that you have the user ID, you can add them into the directory settings panel. To exclude multiple users separate them with a comma like into the screenshot below here. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f72c7d3a7a4d77f595/5d6cf2f105b76.png) --- # Creating a user directory URL: https://wpusermanager.com/article/161-creating-a-user-directory/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e22c7d3a7a4d77f568/5d6cf2db3652c.png) WPUM comes with a useful feature that allows you to create user directories on your website. A user directory is a list of registered members on your website grouped by different criteria. Each directory can have it's own grouping criteria. You can create as many user directories as you want. To create a new directory navigate to "Users -> directories" and press the "Add New" button. Add a name for the directory. The name is not important and it's only useful for you as a reference. It is not displayed anywhere across your site. --- # Directory Sorting URL: https://wpusermanager.com/article/91-directory-sorting/ Last updated: 2019-09-02 ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cef9d2c7d3a7a4d77f4d9/5d6cef9713372.png) When creating or editing a user directory, the "sorting" panel allows you to specify which sorting criteria will be visible on the frontend and which sorting method to use by default. ### Directory Sorter The directory sorter is the filter on the frontend that allows your visitors to change the display order of a directory. If enabled, through the "Display sorter" option, a "sort by" option will appear on the frontend like displayed into the image below: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cef9e04286350aeeb527f/5d6cef976d201.png) ### Amount filters If enabled, the "results per page" filter will appear on the frontend. This filter allows your visitors to select how many members they wish to display per page. ### Sorting Method The sorting method option allows you to specify the default sorting method used into the directory. Furthermore, the "sort by" dropdown menu on the frontend will use this option as default selected. Directories can be sorted by: 1. Newest users first 2. Oldest users first 3. First Name 4. Last Name --- # Add a directory to a page URL: https://wpusermanager.com/article/159-add-a-directory-to-a-page/ Last updated: 2019-09-02 Once you have created a directory, a custom shortcode for that specific directory will be available into the directories list panel of your WordPress dashboard. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e22c7d3a7a4d77f568/5d6cf2db3652c.png) 1 Copy the shortcode from the "shortcode" column. In the above screenshot, the shortcode is `[wpum_user_directory id="316"]` 2 Navigate to "Pages -> Add new" into your WordPress dashboard 3 Paste the shortcode into the page content editor ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e204286350aeeb531b/5d6cf2db95f78.png) --- # Getting Started with the ACF addon URL: https://wpusermanager.com/article/229-acf-getting-started/ Last updated: 2020-05-28 The WPUM Advanced Custom Fields addon allows you to use custom fields created with ACF in your WP User Manager forms. With the plugin installed, any ACF field group that relates to a WordPress user (i.e you are defining custom meta to be stored for users) will have a new 'WP User Manager' metabox: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf7c522c7d3a3dea3d2879/file-TE5gAgvljK.png) ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf7e4e0428632fb9006e5d/file-jy7AMw2jIY.png) The box has three sections - ### Registration Form Here you can choose for the fields in the field group to be added to the registration form, so users can enter the data on registration. If you are using the [Registration Forms addon](https://wpusermanager.com/addons/registration-forms/) then you can select any of the forms. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf7e690428632fb9006e60/file-lon3KV3iyk.png) ### User Profile The field data can then be display on the users profile if you enable the 'Show fields on user profiles' setting. The group's fields will appear under the primary settings on the 'about' profile tab. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf7ff62c7d3a3dea3d28a7/file-aToO8sO74h.png) If you enable the 'Show on profile tab' setting then the field group will appear on a separate profile tab: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf80360428632fb9006e70/file-Dcl4ALvkGB.png) User Account If you enable the 'Allow users to edit fields' setting then the group's fields become available to be edited by the user the edit account page: ### ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf7f790428632fb9006e68/file-C8SDM9b3dL.png)Per Field Settings You might not want all fields in a group to be public. You can enable the 'Hide from User' setting for any field, and it will not be displayed on the registration form or profile. This is helpful for fields that are for admins only to update. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ecf814d2c7d3a3dea3d28b6/file-Ng8ga4Xeek.png) ### Support Field Types Currently WP User Manager supports the majority of the ACF field types: - Text - Email - Select - URL - Textarea - WYSIWYG - Checkbox - True / False - Radio - Number - Date Picker Those that aren't supported will not be shown. --- # ACF Installation URL: https://wpusermanager.com/article/228-acf-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM Advanced Custom Fields (ACF) addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/acf/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-acf. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Advanced Custom Fields in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # How to change the restriction message for all content URL: https://wpusermanager.com/article/330-how-to-change-the-restriction-message-for-all-content/ Last updated: 2023-02-05 If you are restricting a large amount of content but you don't want to [restrict all content in a specific post type](https://wpusermanager.com/article/331-how-to-restrict-all-content-in-specific-post-types), then it can be easier to set the message, which is displayed to a user when the content is restricted, in one place instead of editing each post. You can change the message using this code: https://gist.github.com/wp-user-manager/d99ae6ee2406f1b06e8ab8165b95345e --- # How to restrict all content in specific post types URL: https://wpusermanager.com/article/331-how-to-restrict-all-content-in-specific-post-types/ Last updated: 2023-02-05 There are times when you want to restrict all the content of a specific post type without having to turn on restriction settings one by one for all existing content and all new content. This can be achieved by navigating to the Users > Settings > Content Restriction tab. From there you can select the post types which will be completely restricted, and then set the restriction settings to be applied: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63df610d8ae59c3643e33bbd/file-SKy5tlnAol.png) --- # How to restrict parts of template files URL: https://wpusermanager.com/article/329-how-to-restrict-parts-of-template-files/ Last updated: 2023-02-03 If you are using template files in your theme and you have restricted a page with the Content Restriction addon settings, then you may want to restrict other parts of the template, not just the main page content. You can do this using the function 'wpum\_can\_access\_restricted\_content()' in version 1.3.4 of the addon. For example, this is a simplified version of a page template: https://gist.github.com/wp-user-manager/ff7d6c58906fba97b983a013b90cb5aa --- # How to restrict access to taxonomies URL: https://wpusermanager.com/article/303-how-to-restrict-access-to-taxonomies/ Last updated: 2022-02-24 With Content Restriction 1.3 along with restricting access to post, pages and custom post types, you can now restrict access to specific terms of a taxonomy. For example, you have created a blog and you only want logged in users to read posts in the 'News' category. You can do this by editing the category and clicking 'Restrict access to this category': ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6217a174528a5515a2fcc397/file-FZbuEKG8M0.png) The restriction settings are similar to when restricting a post. This means that the category 'News' does not appear in the site for logged in users, as as any post that is in the news category. --- # Getting Started URL: https://wpusermanager.com/article/243-getting-started/ Last updated: 2020-10-12 'The Content Restriction addon gives you more control over the standard content restriction features in WP User Manager. Instead of using [shortcodes](https://wpusermanager.com/article/180-content-restrictions-shortcodes) to wrap specific content that is restricted to certain users, this addon allows you to control entire posts, pages and custom post types from being shown to users. ![](https://wpusermanager.com/content/uploads/2020/10/content-restriction.png) Once you have selected that the post/page/custom post type is to be restricted, you can then select who can access it - - Logged in users - Logged out users If you select 'Logged in users' then you can also specify certain roles who only have access. If a user tries to view a restricted post then you can select one of two things that can happen: 1. Redirection 2. Show message If you select 'Redirection' you can specify the page to redirect users to, or a custom URL. If you select 'Message', a standard message will be shown or you can specify a custom message. You can also choose to hide the post everywhere on the site if a user doesn't have access. This includes menus, and queries on index pages. --- # Content Restriction Installation URL: https://wpusermanager.com/article/240-content-restriction-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM Content Restriction addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/content-restriction/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-content-restriction. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Content Restriction in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Custom Fields Installation URL: https://wpusermanager.com/article/326-custom-fields-installation/ Last updated: 2023-02-01 The following tutorial will guide you through the installation of the WPUM Custom Fields addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/custom-fields/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-custom-fields Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Custom Fields in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # How to restrict custom fields to be only editable by site admins URL: https://wpusermanager.com/article/297-how-to-restrict-custom-fields-to-be-only-editable-by-site-admins/ Last updated: 2021-12-08 Sometime custom field data about a user should only be editable by site admins. Maybe you've collected the data from the user upon registration, but don't want to let them change it from their account settings. To restrict the field from being edited by the user, navigate to Users > Custom Fields and select the Field Group with the field. Click 'Edit Field' and then navigate to the 'Permissions' tab. In the 'Profile editing' setting, select **Hidden**. Click 'Save changes'. The field will no longer show in the account settings page.![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61b0bc9248287b457880a045/file-SpzD31lHNh.png) If you do want users to see the value but not be able to edit it, then set 'Profile editing' to be, select **Publicly editable** and then check the 'Set as read only' setting. --- # Adding custom field data to the new user registration email URL: https://wpusermanager.com/article/291-adding-custom-field-data-to-the-new-user-registration-email/ Last updated: 2021-08-24 When a new user registers on your site, they will receive an email about their registration. This can be customized via Users > Emails > Registration confirmation > Customize. The email content can be customized with the different personalization tags, such as {username} or {email}. But what if you want to use custom field data that the user filled out in their registration form, in the email body? Now you can using special template tags for custom fields. To find out the tags need, take a look at the fields used in your registration form and find the field **Unique meta key**, eg: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6124dcd4b55c2b04bf6e1159/file-MCYBFGl93p.png) This is the tag to use in the email body. To edit the email go to Users > Emails > Registration confirmation and click 'Customize', then 'Open email content editor'. The tag to use will be {unique meta key}, eg {field\_15} ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6124dd95f886c9486f8db8d0/file-hLUecXpLUx.png) --- # Select fields to display in a user directory URL: https://wpusermanager.com/article/290-select-fields-to-display-in-a-user-directory/ Last updated: 2021-10-06 This feature is only available with the [Custom Fields addon](https://wpusermanager.com/addons/custom-fields/) By default the user directory list will show the avatar, name and user bio for each user. But with the Custom Fields addon (version 2.4 and higher), you can select which fields you want to show. When you edit the directory via Users > Directories > Edit, you will see a new box for 'User Fields'. Here you can select which user fields to show and in what order: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6124d9a1b37d837a3d0e6699/file-H0YBnA0LyK.png) Once you've selected the columns, you will need to change the 'Directory Template' to set the 'User Template' to be **Multiple Columns:** **![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6124da57b55c2b04bf6e1148/file-8qA4qoOFoj.png)**Your directory will then look something like this: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6124dab0b55c2b04bf6e114c/file-qnQNNhgwxt.png) You can customize the directory template by copying it to yourtheme/wpum/directory/single-multiple\_columns.php and making the changes needed. [Read more about template customization.](https://wpusermanager.com/article/121-templates-customization/) --- # How to make a custom field unique for users URL: https://wpusermanager.com/article/287-how-to-make-a-custom-field-unique-for-users/ Last updated: 2021-05-30 If you have a custom field that you want users to fill out at registration but the value has to be unique, eg. it hasn't be used by another user, then read on. First set up a custom field via Users > Custom Fields. Then add this code to a wpum.php file in your /wp-content/mu-plugins/ directory (you might need to create the mu-plugins directory). Change the field key to match yours, which you can see when editing the custom field. Also change the error message to make it more related to your field. https://gist.github.com/wp-user-manager/85437727785153605bd2cd6ddd87aef8 --- # Creating Fields With Conditional Logic URL: https://wpusermanager.com/article/281-creating-fields-with-conditional-logic/ Last updated: 2024-07-15 Using conditional logic in WordPress allows users to create dynamic form fields that collect only the most relevant information when needed. If you want to provide your users with all the necessary fields but don’t want to clutter your form fields, then a conditional field is the best option for you. Conditional logic allows your WordPress forms to change or show additional fields based on the user’s selections, show custom text fields, and many more. How To Enable Conditional Fields -------------------------------- You can use conditional logic to most of your forms field depending on the information you need from users. Let’s take for example this simple Registration Form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/664196e601809474d8e85679/file-efuWVpxDeV.png) [](https://share.zight.com/v1u9rv94) You want your users to also add their phone numbers instead of just their names and email addresses. To enable conditional fields on your WordPress site, go to your Dashboard, navigate to Users > Custom Fields > Customize fields. [![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/66419731d6096e7b935cca6a/file-uxnl1HG0V0.png)](https://share.zight.com/04u8KenZ) You can either edit existing fields or add new custom fields. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a657e1989867dceff3ad/file-oF494hRsMz.png) You need to have separate fields for your existing fields and your conditional fields. Your conditional field is the one that will appear if the conditions are met on your existing field. In this example, we will use the ‘Add Phone Number’ field as the existing field, and the ‘Phone Conditional Logic’ field as the conditional field. To enable the conditional logic choose your desired conditional field and then click ‘Edit field’. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a75ddb62267f9903dff9/file-HAFs4YwFCT.png) Select ‘Conditional Logic’ then turn on the ‘Enable conditional logic’. Select what conditions you want to meet for your conditional field to appear or function. In this example, you want the ‘Phone Conditional Logic Number’ field to appear if the ‘Add Phone Number’ (existing Telephone field) field has a value. Then click ‘Save Changes’. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a7e6e1989867dceff3ae/file-zskG9AiqRW.png) After you enable the conditional field, the next step is to add both the existing field and the conditional field to your registration form. To do that go to your Dashboard, navigate to Users > Registration Forms > Customize Form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a8255940934e140f5fae/file-F2gqTtD0ru.png) On your Registration Form field, drag and drop both the ‘Existing Field’ and the ‘Conditional Field’ from the list of the Available Fields to your Form Fields. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a859dd0f8c60bb3fe610/file-VSYiIzMHIO.png) Your changes will be automatically saved and your conditional field is now ready. Testing the Conditional Logic ----------------------------- To test your conditional logic field log out of your account, open your website, and go to your Registration form. The Existing field should appear, which is the ‘Add Phone Number’ field in our example. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a888dd0f8c60bb3fe611/file-NkE34LKMuf.png) You will notice that the conditional field, which is the ‘Phone Number’ does not appear on the Registration form because the condition is still not met. To meet the conditions you set, input a number from the ‘Add Phone Number’ checkbox and the conditional field will appear below the existing field. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6694a8be5908935e848186df/file-SRbY8UoGVq.png) --- # User Field Type URL: https://wpusermanager.com/article/280-user-field-type/ Last updated: 2021-04-25 The user field is a new field type available in WP User Manager’s Custom Fields addon. This field type allows your users to select other users of the site when registering for a new one. The User Field type helps to define the relationships between users in your site. How To Create a User Field Type ------------------------------- Adding User Field is just as simple as adding any other custom fields in your registration form. 1. Navigate to Users > Custom Fields ![](https://lh4.googleusercontent.com/V1GNj1QfWl7S4Nu4XM0jG6xIYssA5wrIBCT40rBQXwOSHr0Ea1OJjTGkdczSBOVa6kNPSpXqJyD8o80AxcvZpCGWQ1cOcojA8Ni3_5VFoMAbozEwl9fMUhXrTl-0m6dW_NOUAnZ7) 1. You can click the ‘Add New Field Group’ to add another field group or click ‘Customize Fields’ if you want to customize an existing field group. ![](https://lh5.googleusercontent.com/kOw4S8Cm0bzGJ4R3SfUinD6sH9I1tDf3dfdf0cQBIyYS2mSjIqAFhUkBT9zTINHH5HpBtZE0uff96Ci6FpZpytdspDDZnj0V4Pyet-dr4Z-viqritHpBKJXgUnIAKP14hsQV_QEE) 1. Click ‘Add new custom field’ on the upper left side of your field editor page. ![](https://lh5.googleusercontent.com/VKn21mbNyaKNgr0xdSrs-4Q39VoQJhXKGJS2_t9XiTG7XkDBXqaK5lt1R5NgiiL9qG-UeINp3gyMgb93THEw7xGLvtFNgCUyYFFczv-CCFRaeeewTQydMgoGVZWLwIq5idiaZJPA) 1. Go to ‘Advanced Fields’ then type in your desired ‘Field name’. 2. Select the ‘User’ field, then click ‘Create custom field’ to open the settings and options for the User Field type. ![](https://lh5.googleusercontent.com/zh7nuOKf1d9gSLzOhLAb-4xcv9szZWmY8__jh2lGKdEnyX0VY-7aSnzVl1GXE6dGHYGpOHrd_IVlLooY0plS4tv3HCplK3-oUh-ncKyO2S_TqvvWKOCxbZd_WvmK2iEOEYQdHFlg) ### General In the ‘General’ options you can define the basic settings of your user field. 1. You can edit the ‘Field title’ of your user field. 2. You have the option to add ‘Field description’ if needed. 3. It also shows an auto-generated ‘Unique meta key’ that will be used to store information about your users in your website database. 4. You can also put a ‘Placeholder’ for your User Field if needed. ![](https://lh3.googleusercontent.com/PN2_sPxmaVtKFQSa30hOwn3L48wIF05qhDDdrc13ZsSPwG7lWs7d3HXh7HPbZ4q3z_Pk48Y36P7q8kSyCekYjB-grIXiUqYMz8KGkfAZidJ-kvqEQB-VkF6E0EjSuH7pK5NAHmy3) 1. You can also choose to ‘Filter by role’ your User Field and select different roles from Administrator, Editor, Customer, and more. ![](https://lh6.googleusercontent.com/nY-J7LWsTZ2RpyAaMdW2xZo-0uG_5ODkOnqfiSMn1Z4rRMwLepPCZiY5rCsOEhwsd3Oz7PdAH8boaZBP9NjzjyripGqg_Gcll9gKDrWjeTtUVfGb-QDJTbECytrb4jZEBwn9RkGH) 1. You can ‘Allow multiple selection’ and‘Show users with hidden profiles’. 2. You can also put a ‘Type label’ for your users. ![](https://lh6.googleusercontent.com/g-ECe0VEQ7WEjjq2Gq8l5InitPkh9pKwm5WIFlkno0BzrtoR403LeEFIXjCCMxqIWcllF9jWKRitElokk73WJSMojEOMYHWNLmU9L_8HXY-qdT7jIyHLcPz5YkRU2mv_NT49TPX7) ### Validation You can make your User Field a mandatory field to fill before the form can be processed by enabling the ‘Set as required’ option in the ‘Validation’ settings. ![](https://lh3.googleusercontent.com/0Z5rKrx8gFbxm6odnivE0WyTW_kxs0PB3RcwqCmNeg7dFFl3ra19kmalFfApeJhjXnQA9yQnSgHoQp7chRGM5UgFMOKCc2rcS-ZHPKkt4jLOGkDSGjbcugQ77ItFTQwFP7fcLq7l) ### Privacy You can choose to make your User Field ‘Publicly visible’ or ‘Hidden’ on user’s profiles. ![](https://lh6.googleusercontent.com/Iqdb3lQ0DUWTplUD0JdrurW7I6oS8_LdLBsEfHrDcc9-7PrjrBeMx2a6dDa-DMQuGmIw3hETWMYyE1M_V1MT0SADVZt5uhVT0Rl_306i0zlmrKR-j2PAhvsIoUcTnnFids7jqcq0) ### Permissions Under ‘Permissions’ you can set who can edit the User Field. YOu can choose to make it ‘Publicly editable’ or ‘Hidden’ within the front-end of your account page. You can also prevent users from editing the User Field by enabling the ‘Set as read only’ option. ![](https://lh3.googleusercontent.com/um35MHli2pUAFhs58TpT9LIKSUPyG8cyaOgqAtIhkyZKeGyFWdq69-q81tx082FsQPAHfUfh83zAzNiFPXMm-urrHQdPMRPKpwMIF3TWivW8LZPgprhHQaJ_czKg-lWQl93PlYze) For conditional logic, please see our detailed documentation on the conditional field type. <insert interlinks> Once you’re done with the settings, click “Save changes”to create the User Field. ![](https://lh4.googleusercontent.com/xH1qz8w3IxHmVLGb9d17SMV2KsDf_cKo4dVyL4e9a6H0FbAgD7xRNmcCz6rf2fEHklwR8wheBsmuhhPfLbgu1e8KB5WKXjyUUP84vXwmmxBdtflJS5PJUuMJjrTw1IoIS2-OsGaC) Adding User Field to The Registration Form ------------------------------------------ Now that you have created a User Field the next step is to add the User Field to the Registration Form. 1. Navigate to Users > Registration Forms ![](https://lh6.googleusercontent.com/IZ9v4JDB4RRWsKB4Xi9izFKN2uLvIFLYQz240FVamaa_Fh3TX0Rgxh_dqRGeO3156CXFdT1YEo28W-IbiHK8QImVwv_yvUxhMs46sd78d6A52EFoJxGqzTGw006l79o-3mU1ZMWk) 1. You can create a new Registration Form by clicking the ‘Add New Form’ or you can edit an existing Registration Form by clicking the ‘Customize Form’. ### ![](https://lh6.googleusercontent.com/9aZMqByiAO1_O6EwkNnyPqiqBiYVeJOEbm5sc7-7FU_VRcsWnMVnTt4_HOWU2a7cp-eir1W9Bu6f_YOj60W5eYbu5L1ij3hM1jF1PTZFxXANO79gLbYVbo8MUQVGdHkucrz5lQYt) 1. Drag and drop the User Field you created from the list of ‘Available Fields’ to the list of ‘Form Fields’. ![](https://lh5.googleusercontent.com/Z21Hqvj_psVXFhoMeGkoRDVI587EiC3FZHl9okXGg_Iy-MAvyPXm7JnpJuh94E8nttN5wHzPrl0GsCsntE4SFlxseAs3CmlD3G73yE7YY2MHe7rBiHtkWi-gsEV7ufxT1sE1crkQ) 1. The changes you made will be saved automatically. ![](https://lh5.googleusercontent.com/rJ1w87_MYv7QN-7l8oGBsoYG59GRzGyXpqgZwKUiudAOG0Dh5jBzoXT1YndvDHv59kk0EknBa1HWlCbvd4O2HWbcwyFq5iURI7cK3Mw_Ut9Hb3ijG19OnyV-FaCudD7Kbe2d8_Xr) ### Preview Once you’ve added the User Field to the registration form you can now preview by logging out and going to the Registration Form on your site. ![](https://lh3.googleusercontent.com/ElgRGhUCkiZm_MH7Np4xon4BJW6nvWTU0zpwBYd0tgTETSmcmzsjar09uJv1TkKVOn-oP0v3GomxqJ9g5nA9eoq0zFgiEOv5yDIdtGxLxPIPv2OV6iGyu91OdiQu8CDJha0C9zIx) The Profile and Account Page ---------------------------- The appearance of the User Field depends on the ‘Privacy’ and ‘ Permissions’ settings that you set for the User Field. Editing the User Field from the Profile Page -------------------------------------------- Once the user has successfully registered, the user can now view the profile page. If the ‘Privacy’ and ‘Permissions’ settings that you set for the user field allows the user to update and edit the information from their account or profile page, the user can click the ‘Edit account’ beside the Username to go to the Account page and edit the fields. ![](https://lh6.googleusercontent.com/ni0Jrfsj8KbLiOqHaFAwMpua7PF4ytI26dBEVpRN95f25phaCUkCNCUNE-XYnDOronF1dDpSC5Ew582IYi4K_WLXFrSzA-Ygt7ynbLvtg-5PGTMSdV7A7HHCpa9zMWMd7qDdB2r3) --- # WYSIWYG Field Type URL: https://wpusermanager.com/article/276-wysiwyg-field-type/ Last updated: 2021-03-13 The WYSIWYG (What You See Is What You Get) Field Type provides a space for your users to submit text that can be formatted using the WYSIWYG editor. They have the option to format their text using heading styles, boldfaces, italics, and they can even make use of the HTML editor instead of the visual editor. ![](https://lh4.googleusercontent.com/1I4qIrOO-CMIM_hTojhR_AL20p3W5ACFLWNqjUAWaEqcl8vN-SfQfKpXlk6B02u4bnhaYPXMEX4RT9PdK0rPV3R4QoqXYpDEfLz7_mSO4dFA-07aKfF4PHpRVzeiNIUrTnM0VN6A) Examples of use cases for this field type include: asking your users to submit formatted text, asking for permission where formatting is important, enable HTML input capabilities on the submissions. How to Add The WYSIWYG Field Type --------------------------------- Adding this field type is simple. It functions just like any other custom fields that you want to add to your registration form: 1. Navigate to USERS > CUSTOM FIELDS![](https://lh6.googleusercontent.com/j3f6Ad07OenPE-4CCniylFiMJGQAz_VVnq_Kzdz6HFc0Iw6ng6n9E074FfjPUjR5EpF7KilMpSLonfcRM_GPMo3mTtVllwWAeunYULSYXLbpJ89L0MKTsOu0jCo7xq5Tf_z5oR02) 2. From here, you can choose to add another field group by clicking “Add New Field Group” or customize an existing field group by clicking “Customize Fields” next to the name of the field group you want to update![](https://lh6.googleusercontent.com/zlxdeN-Jzeq9iXgoIRW-zU1oKkkbGdcAsZjLkUnF6ZiDVE40oN1YSqghJn6TUtqwG7s2X8FNkVRjiRbT9KI6JYXfkSWKifGG3RLyrqD_Wn6Ma7sASzM_wEkkBkCVu8RL8H2kKWVm) 3. Click on “Add new custom field” to get to the custom fields popup.NOTE: In case you already have a WYSIWYG field type selected, just click on “Edit Field” to update that existing field. ![](https://lh6.googleusercontent.com/228nnJLn7NKzSdXIqOLYKZ6B16DQNJ4DnCBcsV-EQTlqMnEJUEpNM1fyehTLrCHqkdyMMAhlq6rSQ-qY-4eA7DwsipwWj8Q8Uh4ER0leVZr2I98QZC8d5mKiXzd2-YXM50t_QgHO) 4. On the popup, click on the Advanced Fields tab 5. Add a Field name 6. Click on WYSIWYG 7. Click “Create Custom Field” to create your new field type![](https://lh5.googleusercontent.com/0qnV5j0vyU16yeJkIxuo5TzOvwv8-NIi9VELddp_pvUXY1QMq8uGIM7N0q1OlWMIH86z6gr1Qe1o_0W26EqDAQg6G76JvlAnUMcp0tRMyKaVrrFsA9I0rV2qezHKgdJ9vpYx-8AK) Once your new field is created, you can update the settings accordingly. ### General![](https://lh4.googleusercontent.com/RqxOZoGra1MD9NJ2w-YNel6X505XNY8nQIb6nDY9gtAeoGBkwtlLWp3Vg73kjpll8o9cdbSh_r1cDMSnB0KZIjfodv0qdmU1Zlk6I70uNTKjEi1j_rvWuUvB9dHXUAYkTbTqa-O9) Under the “General” tab, you will find the following settings: - Field title - the name of the repeater field that will be displayed on your registration form. - Field description - this optional field is the text that will appear as a description within the forms - Unique meta key - this field is important to specify or remember since this will be the tag of the data or information about your users that will be stored on your databaseNOTE: The key must be unique for each field and written in lowercase with an underscore (\_) separating the word, e.g., country\_list or job\_title. Errors might result in adding the information on the database if this field is not properly formatted. - Placeholder - this will be the placeholder text that will be displayed on the field in the registration form. You can leave this empty if it’s not needed. It’s good practice to pay attention to these fields since these will be the basic settings needed for the field. ### Validation![](https://lh4.googleusercontent.com/rwd3oBbvUvYxqVxYvtaOnSMS7R1r-VlkLP3I3DJW9dmcSav6K8aRPWpoB3Uvlf2gGwkpeV4RX8aG1g33ZWo8NrpfVo37-SYGXLvu8k_uDqJfJ9k0_KthvV820T3fOXPUzHAeTX7Y) The “Validation” tab provides settings for requiring user inputs on the registration form. - Set as required - enable this option to ensure that the field is filled out before the form can be submitted. ### Privacy![](https://lh4.googleusercontent.com/nar1aHVj-lRZc5dH9VRYzMwoKqaZWyIFYGgld6wSmqfRqFK-KUT3FWfJi1vLwxH1amnw8tDPB0nfvZThzDFJIhyVWWv2GeuBIhCczCU4HIQ1RqQAuThCo1wL4pFyYQkTCHaxGXJS) The “Privacy” tab provides the settings to control the visibility of the information on the user’s profile section. - Profile visibility - this setting sets the visibility of this field on the user’s profile pages. ### Permissions![](https://lh3.googleusercontent.com/Z8or7eNQWsY3ZfHypT1Pug3yEet7XUiASNfeJW9nCap6o0i9k3y_YkZ9VLu7zwpHTPGh6oFA5UTUtLg6lw291hHfCOe9gYQ7GPEwu5AM3PhuNWcTE6_AbYDKnmpAfkWnp9z8EiqZ) The “Permissions” tab provides the settings to control what the users can update or edit once the registration form has been submitted. - Profile editing - this setting sets who can see and edit this field after submission. Setting this to “Hidden” will not allow editing on the front-end profile page. - Set as read-only - enable this option to prevent users from editing this field on their profile page. If the profile editing is set to publicly editable, the field will still be visible within the account page but will not be customizable Adding to the Registration Forms -------------------------------- Once you’ve set and created the custom WYSIWYG field, it’s time to add this custom field to the registration form. Here’s how you can do that: 1. Navigate to USERS > REGISTRATION FORMS![](https://lh5.googleusercontent.com/YwbFUJAtrZaXg4qXXrGOnZwcyroEpOXuaqLNw68GrMKKXp109Z-6S5V-oNRM4N3SmFhq4MGst8kSg6fKmjq2DBx8jMnWEjuX-uQv7Rsb16wkWG0qkfAopsOhMIt-_asLFZjqZ6fy) 2. Click “Add New Form” in case you want to create a new form with this field, otherwise, click “Customize Form” to customize the existing form. ![](https://lh3.googleusercontent.com/kokctGO-OT-90TWSyvzv40Y0q1V4kf1FBjt3nZL5wndx3mW802m1xZTGGWhN0im5lPdDdGAw9z9hJCXj7LPe_GF-fraPW_QitX1Ans28SVSg642CxRKyE3UOwIB3CGandGCs9p2B) 3. Drag and Drop the custom field that you created under the “Available Fields” from the right column to the “Form Fields” on the left. You can rearrange the fields as you see fit. ![](https://lh4.googleusercontent.com/Xwb5zwDqyKRaPHy7Q0LrFW_Y6lwRr9bv9jDDZY7ENNqc1aJ5J55J_aqL5wjhTOea9hwvx_pejFm3MjMpBIxUF1XIcZ7hhxEUm1efwhk9aV8691k5CBrhVBeO55jC24ageGLl3T6t) The changes are automatically saved after you make them and will take effect immediately. ### Previewing the Registration Form Once you’ve updated the registration form and added the repeater field, since the changes are automatically updated, you can preview if this works by logging out and replicating the registration process. ![](https://lh5.googleusercontent.com/hejjNTAvxGhwKde31GPm5nyP5rpY4I4IQG4XRvMpCSRBj6LF99jYU_R83fm1HI6uGy2htizvmzkJGpcJMEx3Zi7xHszC9JM5WLozklLc2Lgj3Y4APpfh01oqMlmUwm5rP2DcF5n5) To update your registration, profile, and account pages, add shortcodes including parameters, read more on this documentation page. On the front-end of the registration form, the following format abilities are available to the users: 1. Heading styles 2. Font styles (Bold and Italics) 3. Lists (Bulleted and Numbered ) 4. Blockquote 5. Text Alignment (Left, Right, and Center) 6. Insert/ Edit Hyperlinks 7. Read More Tags 8. And more under the Toolbar Toggle option: ![](https://lh4.googleusercontent.com/xnjpkRMl8R7Xjy7DFw5ztVIPT0N6OJwx1FpTPc_KaD48usJGGGQmj2H9oxsYW1Vf9bDsXVgpuk9kWresTZOH7xTQxsu0s38gn010ile3S9V4kAfW3BDOJvwX65YfI4USny3fk0Sh) Clicking on the “Text” button at the top-right corner of the editor will open up the HTML editor for this field. ![](https://lh6.googleusercontent.com/vyVGTIuolGUaGIY_58_p_AuRJZjt0LuTiap-fdYTHL5Geu7EpSQZ0SbnwMUIEDY6pXp1KKx8-ub5AvEM4p9VtuukZ66E2xeVFJ540543IU-johZOs46TepAcXrG9t37iGTrJLt1A) The Profile and Account Page ---------------------------- Depending on the setting that you set under the “Privacy” and “Permissions” tab of the custom field, the information that was submitted can be seen on the user’s profile page. ### Editing the WYSIWYG Field from the Profile Page Once the user has successfully registered, and if the “Privacy” and “Permissions” settings that you set for this field, the user can easily update and edit the information from their account or profile page. ![](https://lh4.googleusercontent.com/6QVNR71L2mPzhe2vfjbbmNLsbY3J7zYazC-pUny0HUB4z7hb7UKBxyPbx8H1Ze1pTiaOFdJ_W2VeK72ffMJkb5BDKbwS-WUCQ7Hgrf0XaEnirLYr6amKcHwnF44QFgvYdpMVU_NK) From the Profile page, click on the “Edit account” link next to the username to be directed to the Account page where the users can update the existing information on the fields. --- # Audio Field Type URL: https://wpusermanager.com/article/275-audio-field-type/ Last updated: 2021-03-13 The Audio Field Type is available to collect audio files from your users upon registration. With this custom field, you can control the types of files submitted, control the visibility of the audio files, and whether or not users can replace or edit the information submitted after registration. ![](https://lh4.googleusercontent.com/cr91SWzbFFhJUHMHcC62xr-rcYNN-N8eUkP0fjJgpPaqVAXiXxUnMSmCnT_-CB9gTi7FPZZtqP7ZRe6_ZhBjdBliGPgIaVpqLETxlWT2CDSJzQUKcgz4ltMkdx8373qtSnigWcJY) How to Add The Audio Field Type ------------------------------- Adding this field type is simple. It functions just like any other custom fields that you want to add to your registration form: 1. Navigate to USERS > CUSTOM FIELDS![](https://lh5.googleusercontent.com/jUnkAZHJaew2fcDTZ9Nwwag1-g6pKB0_ypLveslpcWDwIUy3VDlLYohkbhf5QuzRTm_FFLWSuGB56mr1B_KnPJ-pmwnLqN9sh7KH_mOwpDxWlZJ4QS8bMl970oNnymb1Cjo1ZdDT) 2. From here, you can choose to add another field group by clicking “Add New Field Group” or customize an existing field group by clicking “Customize Fields” next to the name of the field group you want to update![](https://lh4.googleusercontent.com/p60epW16KAmXd1GYmMMIDLNaDLdFC8aszWp8U4uxmxmzCtGN462d-i_tW6UE9XNI5SM6JYjWbGFtWOonB6vHtvIScoJivhJGWHAhg9XpoNgcvm9oaHvVXMpW7hv3jdgAaEyhotcO) 3. Click on “Add new custom field” to get to the custom fields popup.NOTE: In case you already have an audio field type selected, just click on “Edit Field” to update that existing field. ![](https://lh3.googleusercontent.com/htdnlk8vBhPje-_eskG706VubK8NA7SFPbckHm51XHboV_liSTMofBz5FQ7BAAuLu0HqUCljJFOckGPX6mOyuoM6X-eo1MaZ7YQvQ6G-v8KkCIibpij1hYvqGQGh0rV4yec4VfIz) 4. On the popup, click on the Advanced Fields tab 5. Add a Field name 6. Click on Audio 7. Click “Create Custom Field” to create your new field type![](https://lh3.googleusercontent.com/6JlMZKnoBHXty4RXSFYtWLBdb1wztuZ62ABZ4rJXRUoLuxsuD6h6ra1tht8HfKUEnFeTuhlbpvDATaq-lkSIUKYrJT1ryoCxpk2Xyd9p93_-J1cVTCGavq__KayP4oeAG424jxpO) Once your new field is created, you can update the settings accordingly. ### General![](https://lh4.googleusercontent.com/MFIlymwfOc-bGF4wW9tGolWxUf9NVXHC0WnjYyPFGUh0vxipYADPaXNjEKPrfmTJBv8ixwCKpvpeUp-RkfCi_sQk92tUH2ktH-zQllOzRJZOu-BjF2RZjYWPooAgF7tkstpv6Gx8) Under the “General” tab, you will find the following settings: - Field title - the name of the repeater field that will be displayed on your registration form. - Field description - this optional field is the text that will appear as a description within the forms - Unique meta key - this field is important to specify or remember since this will be the tag of the data or information about your users that will be stored on your databaseNOTE: The key must be unique for each field and written in lowercase with an underscore (\_) separating the word, e.g., country\_list or job\_title. Errors might result in adding the information on the database if this field is not properly formatted. - Placeholder - this will be the placeholder text that will be displayed on the field in the registration form. You can leave this empty if it’s not needed. It’s good practice to pay attention to these fields since these will be the basic settings needed for the field. ### Validation![](https://lh6.googleusercontent.com/fL5Etrg-ztLBkAIee3AXTqrJ_2ndAkb8AeXovTg8Xa-ZY1Ytch2MGWWK8pY-ycQpNfbykNywcWM0XdGbGShO9eJ3zsI6qHxKXaG37pRkum0cVrP6qBf0MhZzH0pSn_RycNtunWlh) The “Validation” tab provides settings for requiring user inputs on the registration form. - Set as required - enable this option to ensure that the field is filled out before the form can be submitted. - Maximum file size - enter the maximum file size that users can upload through this field. The amount must be in bytes. If you want to number in kilobytes, take note of the conversion factor. NOTE: Unless you otherwise indicate on this field, the maximum upload file size of your WordPress install will take effect. - Allowed File Types - enter the file types that you would like to accept through this field. Input must be comma-separated. Examples: mp3,m4a,ogg,wav ### Privacy![](https://lh5.googleusercontent.com/5ZZnhoALI7Zd5MumBjtpdZadAuGhlam5KC_JVM4HnMHcOwM_NQWtp1W097zvXIdKr0dIgeRd8ee17UtKBq1zxQPhMAY-e_dcpexSdScf_LXLxdgPo7DVsyEofdkPsu2JHXqltZxG) The “Privacy” tab provides the settings to control the visibility of the information on the user’s profile section. - Profile visibility - this setting sets the visibility of this field on the user’s profile pages. ### Permissions![](https://lh6.googleusercontent.com/R9ZZ2_M84KHXi05h2WA_Fh9vfuTAHPITFOKEToqibDV-1ykLpMPrF_ER10fMF0-0LNZKGMpH0K-FWpqW6qSe-Ehd35JAhlVzbsxZ6eughI5e0YTXhvXRyO1iCikWjo5YinD-8mCb) The “Permissions” tab provides the settings to control what the users can update or edit once the registration form has been submitted. - Profile editing - this setting sets who can see and edit this field after submission. Setting this to “Hidden” will not allow editing on the front-end profile page. - Set as read-only - enable this option to prevent users from editing this field on their profile page. If the profile editing is set to publicly editable, the field will still be visible within the account page but will not be customizable Adding to the Registration Forms -------------------------------- Once you’ve set and created the custom audio field, it’s time to add this custom field to the registration form. Here’s how you can do that: 1. Navigate to USERS > REGISTRATION FORMS![](https://lh4.googleusercontent.com/2pzy4otD-Te8ry04dUDR8SpPwteaDjijlH63DGXyH07eYXVsJGK2-6LChFX_i0PKMWIAmUXLniW2zS7vbt2lyDxZy6_j6k1s1HW91aSb7J8wzTgFrpvC3p-a5iPHO72OHwZFTHu2) 2. Click “Add New Form” in case you want to create a new form with this field, otherwise, click “Customize Form” to customize the existing form. ![](https://lh6.googleusercontent.com/t1dFG9z7NBswswmq1gwRCiX0IGXZyft9W-KSe7qz8nhuIDCWAI23gvdxy0MZ19u1E8jiIj-VaFPKH8do4QeTL3Aw92dkOpNAwoBTZj2GyJQgL3su1aVJ5Y9VLz67a7G5tTPEbn1d) 3. Drag and Drop the custom field that you created under the “Available Fields” from the right column to the “Form Fields” on the left. You can rearrange the fields as you see fit. ![](https://lh4.googleusercontent.com/R3JJAhaTsWYxqjKDaVMEwqtw_FkRD4fmN8YvJfPihIcECjoZtrV8XDZeuh3kJ4qlldN-kq1V6dyIbeyyXMoUsrd7tTOU3dyn2TlxlIL2qlBANY65NTefeysu7Ja0mhbt-mtSb2aT) The changes are automatically saved after you make them and will take effect immediately. ### Previewing the Registration Form Once you’ve updated the registration form and added the repeater field, since the changes are automatically updated, you can preview if this works by logging out and replicating the registration process. ![](https://lh4.googleusercontent.com/mnjwgy6kilbegS5OTeQWZhi-o1VuM4nO9SIYso1-aJSO6Su4wSUIfHqTdVTKXOIAEvOxAfCEmKFtC7Vy6im0BBqMw0temKfBB1vYHaybjzr-hHbnJq9E3XdkEEtFTVrcNZ9io8Qb) To update your registration, profile, and account pages, add shortcodes including parameters, read more on this documentation page. The Profile and Account Page ---------------------------- Depending on the setting that you set under the “Privacy” and “Permissions” tab of the custom field, the information that was submitted can be seen on the user’s profile page. ### Editing the Audio Field from the Profile Page Once the user has successfully registered, and if the “Privacy” and “Permissions” settings that you set for this field, the user can easily update and edit the information from their account or profile page. ![](https://lh4.googleusercontent.com/bMAm8nZIUr151EfgPmuEvqmJK0q1Vl23gXU8LH-JZvx03zN5TO7H2tiRNTnF8Eb4x6-1SHrZ_APv6SSWjqkP-abbocxXHpwwtwmAj11gzTRTkw7qY0Cv2xE1tsuAanlTrDDT3Aq5) From the Profile page, click on the “Edit account” link next to the username to be directed to the Account page where the users can update the existing information on the fields. --- # Video Field Type URL: https://wpusermanager.com/article/274-video-field-type/ Last updated: 2021-03-13 The Video Field Type is available to collect Videos and video files from your users upon registration. With this custom field, you can control the types of files submitted, control the visibility of the Video files, the maximum file size and whether or not users can replace or edit the information submitted after registration. ![](https://lh4.googleusercontent.com/p2QzbqSRq3biptd9XuztGIMG7iAd-YK5ZaOSAqfiQySfmeyLHGBxT4lDCxoBoQNxd803O1J_lGhiK2G5b8asmAQKk8X5fVL22YH0plpyu4fAjEmNacKvJtwHL40u9wPxFNb2DPTj) Examples of use cases for this field type include: asking for video samples for verification purposes, an employment site asking for a video recording as part of the assessment, and many more. How to Add The Video Field Type ------------------------------- Adding this field type is simple. It functions just like any other custom fields that you want to add to your registration form: 1. Navigate to USERS > CUSTOM FIELDS![](https://lh4.googleusercontent.com/fJVAxpNekmVz5JJQHxi_bcSzlir4v9G-fe_YMUVK43wp74L0HlYzTzIVO1CpProTxuXtR7Z_o03AYClY4W3fjvT_49GpZBp7-yIKU0RT91ki-fSzw71XZHLNnOfZDWdQHsSTyScJ) 2. From here, you can choose to add another field group by clicking “Add New Field Group” or customize an existing field group by clicking “Customize Fields” next to the name of the field group you want to update![](https://lh5.googleusercontent.com/-6t9-W6oRpR4EIDZrsqDbq7qvn_4JTYnYrMWQZ--Et1IorJSKcT0gsL-TYH6rrn5R7JMBT8PTbfzLzFq7tmw4JheFtB-ivelHEuvLh2MbrR8ak6ptmt7pD9uy8_O3-BYpOx3R7ys) 3. Click on “Add new custom field” to get to the custom fields popup.NOTE: In case you already have a Video field type selected, just click on “Edit Field” to update that existing field. ![](https://lh3.googleusercontent.com/17QvuKxqVusRf_F0jEgGNla8ad8MRlBnSFycDBotHtXoSRnCUAqXYXozKneowWg8mbQWLgZAyyEfF0XV03YGamC_8gPLk0TehFQNtkE21nD-SMiix85rjR6IN53l_VuSE6kDeRDE) 4. On the popup, click on the Advanced Fields tab 5. Add a Field name 6. Click on Video 7. Click “Create Custom Field” to create your new field type![](https://lh6.googleusercontent.com/EjcZsyvubXznQvWMMzwwNqkoQhPI-cd3qWsDwq1_gCkWXgpSjBmjyhU5ZYh33ZhkpCIkv5mCV5BLbD-bho6zmA9QzmUcxs-cU14HapJ7Nc59XELH_4mHwx2r1ZcHd_2edsURH6En) Once your new field is created, you can update the settings accordingly. ### General![](https://lh5.googleusercontent.com/YPgd9nbeeT7SROtEnBl96taK3y3zB-bbsnPIc-Ie0Y6MADwgwGJj65hQNMg9aZmJt8UJzznJP-A5w5CK7rflIJxhGPB0AGGAGX4Dv0lQaflolswQjHTXNanTc0z-4Zcr0WIifLaG) Under the “General” tab, you will find the following settings: - Field title - the name of the repeater field that will be displayed on your registration form. - Field description - this optional field is the text that will appear as a description within the forms - Unique meta key - this field is important to specify or remember since this will be the tag of the data or information about your users that will be stored on your databaseNOTE: The key must be unique for each field and written in lowercase with an underscore (\_) separating the word, e.g., country\_list or job\_title. Errors might result in adding the information on the database if this field is not properly formatted. - Placeholder - this will be the placeholder text that will be displayed on the field in the registration form. You can leave this empty if it’s not needed. It’s good practice to pay attention to these fields since these will be the basic settings needed for the field. ### Validation![](https://lh3.googleusercontent.com/C3EmAL2m9C9w-GkEICze28vJpWodwrjdIe6-ClcVBxmv3lJjqvUr27M1VqyRN2X-VYewgRoOzVaRR9XgAom5BARswdV4mlepNPqKTZ2V1ceN4g16upEuJL-xy0o0ud9QquGpN3Rm) The “Validation” tab provides settings for requiring user inputs on the registration form. - Set as required - enable this option to ensure that the field is filled out before the form can be submitted. - Maximum file size - enter the maximum file size that users can upload through this field. The amount must be in bytes. If you want to number in kilobytes, take note of the conversion factor. NOTE: Unless you otherwise indicate on this field, the maximum upload file size of your WordPress install will take effect. - Allowed File Types - enter the file types that you would like to accept through this field. Input must be comma-separated. Examples: mp4,m4v,mov,wmv,avi,mpg ### Privacy![](https://lh6.googleusercontent.com/UJ5j-fARSGQWooOnsEaUkq9hz9VJLGkxv5sEScCXGgDtu348ebcFtr6sYETUndMkw91cNnfUW6JzX1_Mvxt4B6Uq47i2bNER4q7LtfbXVQDJnPq6p4N4u72fXclr9OhEqk9IUPm6) The “Privacy” tab provides the settings to control the visibility of the information on the user’s profile section. - Profile visibility - this setting sets the visibility of this field on the user’s profile pages. ### Permissions![](https://lh3.googleusercontent.com/slNe2Ug0yJarusO6UXThotT-ghtJTf49Ugr_BLeGEhLNtjsOrxGeNBhRONTdF7RSWlcyF5taLaeYYBzXxrJT7HLPmA-Fdpj0wsW7WFoJwtVJoo23ezYmKwk0pZSQJbLXVEnV-6NC) The “Permissions” tab provides the settings to control what the users can update or edit once the registration form has been submitted. - Profile editing - this setting sets who can see and edit this field after submission. Setting this to “Hidden” will not allow editing on the front-end profile page. - Set as read-only - enable this option to prevent users from editing this field on their profile page. If the profile editing is set to publicly editable, the field will still be visible within the account page but will not be customizable Adding to the Registration Forms -------------------------------- Once you’ve set and created the custom Video field, it’s time to add this custom field to the registration form. Here’s how you can do that: 1. Navigate to USERS > REGISTRATION FORMS![](https://lh5.googleusercontent.com/kFxNASiz8rfFIoEDduRkt4vhFliNjcgquSZ6r_JzAF_1LvMclkBMvZvfg86OfzDqDZyNp4tfmKhJ6V6zWjDIJI5WLXx4IoA4JfnGpFwIFlKPOry6R60MGyuXo6SWegTsxJ4e3b8c) 2. Click “Add New Form” in case you want to create a new form with this field, otherwise, click “Customize Form” to customize the existing form. ![](https://lh4.googleusercontent.com/11JvK-rmxPWNCEbla6o1Uso3ZQWbd8ey2Jmb5VRBNZzi7BQ0ZIImpiF-DvlrjtksUENtOO0iJ7s17zBdW7njo_-7_YVa4y_-SsBsIQ3trp10yd9cx-q2g0is3gr8h9yNAZasOsRa) 3. Drag and Drop the custom field that you created under the “Available Fields” from the right column to the “Form Fields” on the left. You can rearrange the fields as you see fit. ![](https://lh4.googleusercontent.com/z23y0g5R3lv5ql0Nyp_TpfilDJ439KUl8U05HsGEzAAmY0ZFOiKFMEEXmJJRdZ_ah8WWlcRanNhrBrtmcsUHUf73tsYJDYCQwBrjxLvFbExVthkqSz4thH5nWoHVBNHxCUpqUPuZ) The changes are automatically saved after you make them and will take effect immediately. ### Previewing the Registration Form Once you’ve updated the registration form and added the repeater field, since the changes are automatically updated, you can preview if this works by logging out and replicating the registration process. ![](https://lh6.googleusercontent.com/FlfqRg0DV9N7mjB7IZHGfXd1OzYQFKHDeTpYbvBvbRj4CUUILmgNl9GH3eKczIIZzoSpTNGnlUsEiHEO0VjDkUaKokG9X1_L63jiRy5fWheUxykoFJsY0jjzLXo4JjqIpEdmJ2AK) To update your registration, profile, and account pages, add shortcodes including parameters, read more on this documentation page. The Profile and Account Page ---------------------------- Depending on the setting that you set under the “Privacy” and “Permissions” tab of the custom field, the information that was submitted can be seen on the user’s profile page. ### Editing the Video Field from the Profile Page Once the user has successfully registered, and if the “Privacy” and “Permissions” settings that you set for this field, the user can easily update and edit the information from their account or profile page. ![](https://lh6.googleusercontent.com/9wbtLi7zk-8RdELSluk3qcGch9-h1jyhlP5BlMB8MshArVlPLesbCGP00hTC9u_5ika7QEljeNMmQOMKFnBCmwR_qDbt5N35LT2HvHnwIMEhz7YCEd66oN7dWTKIzhHEnGTzxtvl) From the Profile page, click on the “Edit account” link next to the username to be directed to the Account page where the users can update the existing information on the fields. --- # Repeater Field Type URL: https://wpusermanager.com/article/273-repeater-field-type/ Last updated: 2021-03-13 With the release of WP User Manager 2.4 and the Custom Fields 2.2 addon, came the release of the newest field type, the Repeater Field. The Repeater Field allows you to collect complex data in your registration form from field groups and sub-fields. Essentially, if you want to collect a number of a set of information from your users on registration, the repeater field is the way to do it. For example, you need information on financial incentives to give you your users based on the number of dependents that they have. Instead of asking how many dependents they have, and having them list the names and other information separately, you can make use of the repeater field and the sub-fields to collect that information. Your user can simply add the number of rows, or field groups, applicable to them. ![](https://lh6.googleusercontent.com/NbmrR0lcxP3Ch9z9_tM2-Icw0xvLDBOLpHptbcCNzM9Q8VcG49WWKgihyMyx2Pl34Ogb3WXu6BCy_JArM_5rijUYSH_HEbUcBJTiXsdcZCeBZuTQ9qWLM4teZ2HFaBbLoSbamCmk) How to Add the Repeater Field ----------------------------- The repeater field is a new addition to the custom fields addon for WP User Manager 2.4. You can locate it under the other advanced custom fields for your registration form. NOTE: Both WP User Manager and the Custom Fields 2.2 addon need to be installed and activated to see these options. 1. Navigate to USERS > CUSTOM FIELDS![](https://lh6.googleusercontent.com/Pq0xw04XcXpjJJHJwUbQg98IjPBTqzcIavZFzPYWe9IfBz2mFP8Pd5mtwpQtgdHfLKPQc6GSLTS9oHMtCT0YDHfGWugG9U1c4LdIxWqrotRdCud-kIruEIA2JZ1zqYT0kvH_Gb0Y) 2. From here, you can either choose to “Add New Field Group” or click “Customize Fields” to customize your existing Field Group.![](https://lh4.googleusercontent.com/9b-tg3_wsAPFsBzjKWjgiFDVnOMrVqL09Fj1yNGYRdltKAOCMh0iYVF-5kG4NQxAWpo1Pwa1K3N_5_JBYomJuyMDIvzfSlxN8Va7AYy-NglnFGwITRVUVjOYZI48L7RqYGzuIMKs) 3. From here, click on the “Add new custom field” button.![](https://lh3.googleusercontent.com/Z1kyou2AkmTkm-k45NYTnKwZRPK362fac-1cvLdkly2tOJauIrwODdH9BGV_FGLTxJ5eqHPsoLD1ubYQcKbYw_DTDn3KDqpSksO4jWN6DeJhAqlrxiWnK7bFRo0EyidBESIjOSqo) 4. Click on the “Advanced Fields” Tab 5. Add a name for your Repeater Field 6. Click on “Repeater” 7. Click “Create custom field” ![](https://lh3.googleusercontent.com/labFy63QW-w26u7a_BFdtyOF8JPIaZjHsH83dcU1LF37fVH4PgXRGGUZgBQThwURSqJ077bPYelvgF9KY1V3BXR0ToJS0596DJO1Xr5gKX1bbR6SVl0dVHvEVEvRZptFBmFYpUHA) After the field has been created, you will immediately be shown the options to customize your repeater field. ![](https://lh3.googleusercontent.com/8csU06YxfP8CUG-ModqY8oxhG6DWrJlvkMfmEcODjk18laHX5FlyBsnFFBAdaeRAwN99w5VjvvyXbzz9fXU6HGqDVcrkOjeSscjFhLO2MkawO5I2T-gU1s9H6BX2gBBqBzuN1a2m) NOTE: You can make the changes now from here, or you can close it for now and come back to edit it later. ### Adding Sub-fields Once you’ve created your new custom repeater field, you would have to add sub-fields before you’ll be ready to add them to your registration form. Adding sub-fields is the same process as adding any other fields to your form, you simply have to add the necessary fields that you want to be repeatedly asked once the user decides to add a new row for their entries. ![](https://lh5.googleusercontent.com/jtn0vmjsJ5F3o-2TITXKFvrG-GvWcUlxiiEbydIczkl23eZake4-S_KG_mKc4OZnKAjHxu6LuB6MXNm54oZnxpuAmkspNI1lB17yh-3M4VicJDC4MaCJ4_hCCZFg-k5-Iwy4_u7H) #### Sub-field Settings Similar to adding normal custom fields to your field group, the sub-field settings on the repeater field will have settings and will require you to put in all the necessary information. ![](https://lh3.googleusercontent.com/zvgYY4AmDb4i2mHS7mUkhh1NBTq7L3xWVgVldn5_x3uPoeYLoiekX0DeTCaQ_BTvUk0JToFtI2hLTtTU4sAbn0a3Zo_a9lFIPT2izovlREaSTWuqJb1d-Xav897tVs9LLIfhQvD8) Be sure to only add the information you want to be repeatedly asked your users upon registration. Take note that if you will be asking for names and email addresses, the entries on the sub-fields will not be considered as registered users. They will act just like any normal entries on the registration form. ### General ### ![](https://lh3.googleusercontent.com/Vt1GRcWqqnADs5LQjavh1WfhtAlzxnCK5wG-GCYE2nziDuUI0WONTCnkow4Ifa4ygovx-q6r98Mwo0c3wiR0_j-nR8kQHviTzMGSBTsNtg2xj42gzxxJOLe53zWOwmXjGMo7EF9v) Under the “General” tab, you will find the following settings: - Field title - the name of the repeater field that will be displayed on your registration form. - Field description - this optional field is the text that will appear as a description within the forms - Unique meta key - this field is important to specify or remember since this will be the tag of the data or information about your users that will be stored on your databaseNOTE: The key must be unique for each field and written in lowercase with an underscore (\_) separating the word, e.g., country\_list or job\_title. Errors might result in adding the information on the database if this field is not properly formatted. - Button label - this will be the title of the button that will appear on the registration form whenever a user decides to add another row of the repeater field It’s good practice to pay attention to these fields since these will be the basic settings needed for the field. ### Validation ### ![](https://lh6.googleusercontent.com/iYtLsCQVSzQkuDM7JB16w0404A0ySk6KN7uc_HQJ3LdHPkA3jGHKQiBd8Nxl-01VNayfnBcTqybHMgPa9VpdFf3ynynQITFU93sjm80mBXw0bqIGMzW0rSpmSmVI-cDgZzJYRzon) The “Validation” tab provides settings for requiring user inputs on the registration form. - Set as required - enable this option to ensure that the field is filled out before the form can be submitted. - Minimum rows - this field will set the minimum required number of rows, or repeats, for this field, leaving it blank defaults it to Not Applicable - Maximum rows - this field will set the maximum number of rows, or repeats for this field. Leaving it blank defaults it to Not Applicable. ### Privacy ### ![](https://lh5.googleusercontent.com/um7-UL_ItVXmyDX1pB-QxfsSKU0f3Amx0fMbmXZlT-mK0SkCPhh8V7JFYHHIN5fZHGrrcyfgtVlu7oOX0bZyZht4ypP7CfuOqksMvioVO5FV4tAMG0-4Vj4En4SBGscvWIZNlJas) The “Privacy” tab provides the settings to control the visibility of the information on the user’s profile section. - Profile visibility - this setting sets the visibility of this field on the user’s profile pages. ### Permissions ### ![](https://lh6.googleusercontent.com/P03s_BoKwa8ZmbPQqGFx8XUSwIonD8BFzCxqytAd15JodbevUde8WcTnva18xLHLjIqSd3x7_gJY-4z2Hz0U_7dC7U8J_telGuVvme_rZWDbjtHsP6fI-j_lPTY_Of_g-YPOgAs5) The “Permissions” tab provides the settings to control what the users can update or edit once the registration form has been submitted. - Profile editing - this setting sets who can see and edit this field after submission. Setting this to “Hidden” will not allow editing on the front-end profile page. - Set as read-only - enable this option to prevent users from editing this field on their profile page. If the profile editing is set to publicly editable, the field will still be visible within the account page but will not be customizable Adding to the Registration Forms -------------------------------- Once you’ve set and added the Repeater Field it’s time to add this custom field to the registration form. Here’s how you can do that: 1. Navigate to USERS > REGISTRATION FORMS![](https://lh6.googleusercontent.com/n0Lt1DoDEqTVFhxyn_c7c_3M54p1TVUolig0WthBP07kHxmsmj9z8-h7cKx3xPHUmfmKdpyAXg7FiMYRNg-rsIPNTq5eP2WQM6XUNaEvQrsiJRjJRUukfCAjvOsk755VGe7ijo0y) 2. Click “Add New Form” in case you want to create a new form with this field, otherwise, click “Customize Form” to customize the existing form. ![](https://lh5.googleusercontent.com/Osp1QEx-stF-2ZzeJu9Y6XVVP5zGBDtRMjkRD6kmYWMQSV6u-ZSyxv1hecgvej8RpgChVi0Jsn_iM65KL8WMmNng5ET0XBTKbapFVRbjmfaGe3rjLsIicG1WQwWHvura_NnifQwI) 3. Drag and Drop the custom field that you created under the “Available Fields” from the right column to the “Form Fields” on the left. You can rearrange the fields as you see fit. ![](https://lh3.googleusercontent.com/4IHF8hX5MCYW1bncImEq0zuJumN-E7ipbg6kJf-OXy_GSCW5r6-45qJakKsq1gNx83lEBrGfusNcUUQ2FrcZn9h797U1Aj0zml7X8eF8ejEB27OSQPnP38lnz5lIJrimNZNOaPPn) The changes are automatically saved after you make them and will take effect immediately. Previewing the Registration Form -------------------------------- Once you’ve updated the registration form and added the repeater field, since the changes are automatically updated, you can preview if this works by logging out and replicating the registration process. ![](https://lh6.googleusercontent.com/ofqidorvE1hL9riarIbEwEg_vNK-T8hspRlUG0JHhiO7DGxppJpiJYJtLu98vzpzHLWo_uGm05z8QTB3Ru3Yvu7uqujWIeTe_GLJFRghmsgg5KbyHPiMpnvAgFDpd4uk7chAuKDQ) To update your registration, profile, and account pages, add shortcodes including parameters, read more on this documentation page. On the Profile Page ------------------- Depending on the setting that you set under the “Privacy” and “Permissions” tab of the custom field, the information that was submitted can be seen on the user’s profile page and displayed like the below image by default. ![](https://lh6.googleusercontent.com/PZJ3ETVYptdi2F_S34XhS4v3EhC4F0rdJFGJxVM-C0gzm8U9ZjGqF7pV-W4w-quwObNLWmdLjCWby1kgPqmUHbGEhfahHlOJZZaJI_x8xbBDAYO9JU1IsqdnI1xb9OBYqqXk02O-) ### Editing the Repeater Field from the Profile Page Once the user has successfully registered, and if the “Privacy” and “Permissions” settings that you set for this field, the user can easily update and edit the information from their account or profile page. ![](https://lh6.googleusercontent.com/ICQ0-tYCe0MG_0MuLAETdp7mXcMewSu3a4z0yjgCjjayg5kwx0XvQdH66Asdq_-63QykWaR4t2B1-p3qPq8-a-yglV9YmWHQaZ60jrx9fyYHSkzAOM2xzJAsrGhkDLZJJ1I6Eq9j) From the Profile page, click on the “Edit account” link next to the username to be directed to the Account page where the users can add more rows/entries, or update the existing information on the fields. --- # Setting a Default Value for a Field URL: https://wpusermanager.com/article/267-setting-a-fields-default-value/ Last updated: 2021-01-23 As of WP User Manager v2.5, you can set the default value of text, hidden, number, radio, dropdown, and textarea fields on registration forms. You can do this by - - Navigate to Users > Custom Fields - Edit the field - Scroll down in the General tab to see the 'Default Value' setting ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bfb1dc64fe14d0e1fde02/file-TQpVpdIrJ9.png) The default value will only be populated on the registration forms. Setting a Default Value From a Query String ------------------------------------------- A query string is part of a URL that contains information, in the format You can populate the default value of a field using the value of a query string using the following method. - Work out the query string key you will use, eg. [https://mysite.com/register?item=yoga](https://mysite.com/?key=value) the key will be 'item' - Edit the field and add the default value as {query\_var key="item"} (replacing item for your key) ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bfc7ec64fe14d0e1fde08/file-wgS0BSHUd6.png) When this field is used on registration forms, the value will be auto-filled based on the value of the query string. So for my example of [https://mysite.com/register?item=yoga](https://mysite.com/?key=value), this field above will have the value 'yoga' by default. --- # Taxonomy Field Type URL: https://wpusermanager.com/article/268-taxonomy-field/ Last updated: 2021-01-23 The Taxonomy field type allows users to set their own terms for a custom user taxonomy registered for the site. For example, your site uses a User Category taxonomy to categorize users. You can use the taxonomy field to get users to categorize themselves either at registration or in their account. When you create the Taxonomy field, you have to choose the taxonomy (this requires some [user taxonomies registered](http://justintadlock.com/archives/2011/10/20/custom-user-taxonomies-in-wordpress) on your site) ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bfead1c64ad47e4b723b9/file-vM77pZi5mv.png) You can also choose the 'Field Type' that will control how the taxonomy field displays the terms for users to select. The field types available are dropdown, multi-select and checkboxes. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bff2a2e764327f87c1a01/file-kDYrIrES5P.png) --- # Hidden Field Type URL: https://wpusermanager.com/article/269-hidden-field-type/ Last updated: 2021-01-23 The hidden field type allows you to add a hidden input field to registration fields, typically where you are setting the [default value or using a query string to auto-fill the value of the field.](https://wpusermanager.com/article/267-setting-a-fields-default-value) --- # Radio buttons & Dropdown field type URL: https://wpusermanager.com/article/192-radio-buttons-dropdown-field-type/ Last updated: 2019-09-02 The radio buttons and dropdown field type allows you to create a field where the user can select one choice from a list of pre-defined options. ##### Example scenario: 1. Field name: How did you hear about us? 2. Available options: Google, friend, social network The user will be able to select how did he/she hear about us by selecting one option. #### Adding choices: A choices editor will appear and will allow you to add unlimited choices to the field. In order to add a new option, press the "add option" button. The order of the options can also be changed by dragging and dropping them through the icon on the left end side of the option. Note: in order to add an option, you need to fill both the value and the label. --- # What is the field meta key option URL: https://wpusermanager.com/article/185-what-is-the-field-meta-key-option/ Last updated: 2021-04-09 **If you're just getting started with meta fields in WordPress, check out our tutorial on [how to set up WordPress custom user meta fields](https://wpusermanager.com/tutorials/how-to-set-up-custom-user-meta-fields/).** The support for custom fields for users in WordPress is limited and it isn't possible to define new custom fields without a plugin like [WP User Manager](https://wpusermanager.com/). WP User Manager, with the [Custom Fields addon](https://wpusermanager.com/addons/custom-fields/) allows site admins to define custom user meta (such as phone number, address, employment details) that they can add to user registration forms to collect data from users, as well as being displayed on the user profiles. WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. Custom Fields ------------- Every field has a "unique meta key" setting that must be filled. This is automatically created for you when you create the field. The meta key determines how the field will be stored into the database of your website. If you do not need to do any custom development you probably do not need to customize this field. It's important however that if you change the key, it has to be a unique value that no other field has. Using the same key for multiple fields will make it impossible for the user to correctly update it's information. Developers however can freely customize this setting if they know what they're doing. The metakey is used to retrieve the saved value from the database and display it. If you are a developer, chances are you already know about this WordPress function [https://codex.wordpress.org/Function\_Reference/get\_user\_meta.](https://codex.wordpress.org/Function_Reference/get_user_meta) This function is used to retrieve the value of a user custom field from the database through the user id number and the metakey name. In WPUM every custom field metakey has the prefix "wpum_". Note: the prefix for file fields is "wpum_file_". ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f32c7d3a7a4d77f58f/5d6cf2ecf3336.png) This means that the full metakey name is wpum\_field\_11. If you change that to anything else like "job\_title", the metakey will be wpum\_job\_title. Here you can find an example of the get\_user\_meta function retrieving a WPUM field value. `get_user_meta( $user_id, 'wpum_field_11', true );` OR, if the above does not work: `carbon_get_user_meta( $user_id, 'wpum_field_11' );` [Get started adding custom fields to your WordPress users.](https://wpusermanager.com/pricing/) --- # Editing user information as an administrator URL: https://wpusermanager.com/article/183-editing-user-information-as-an-administrator/ Last updated: 2019-09-02 When new fields and groups are created, the fields will also be available to be edited into the user's backend profile. This means that an administrator can freely have access to the user information and if needed, modify them. In order to edit the information of a user, simply go to your users list into the WordPress dashboard, and click the "edit" button. A new section at the bottom of the page will be displayed, showing the fields that you have created and any information the user might have added. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2f204286350aeeb5340/5d6cf2ec26c9e.png) Just like the front-end profile page, all fields have been split in groups. --- # File upload field type URL: https://wpusermanager.com/article/182-file-upload-field-type/ Last updated: 2019-09-02 The file field type allows your users to upload files on your website. All files upload through this field type will be stored into the "wp-user-manager" subfolder of the "wp-content/uploads" folder on your server. | Available options | description | |---|---| | Maximum file size | Enter the maximum file size users can upload through this field. The amount must be in bytes. | #### Field output: On the front-end if the upload files are images, they will be displayed as images. If uploaded files aren't images, it will display the file name only. On the backend, the administrator will see a list of links to the uploaded files only. --- # How to add custom fields URL: https://wpusermanager.com/article/160-how-to-add-custom-fields/ Last updated: 2019-09-02 To add custom fields you must have the ["Custom Fields" addon.](https://wpusermanager.com/addons/custom-fields/) ### Accessing the custom fields editor To access the custom fields editor, navigate to Users -> Custom fields into your WordPress dashboard. You will now see a table with the default fields that looks like this: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e304286350aeeb531e/5d6cf2dc3cecf.png) This is a list of fields group: . Select a group to display the list of fields within that group, once you've selected a group you can add new fields. ### Adding new fields In the newly opened window, click on the "Add custom field" button. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e32c7d3a7a4d77f56a/5d6cf2dc9a9a3.png) Then type the name of the field and select the type of field you wish to create. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e32c7d3a7a4d77f56b/5d6cf2dd0149c.png) Each section contains the fields types that you can add. Once the field is created and you'll be displayed a new modal window, where you can customize name, description, requirements and other settings. Each field has it's own settings. --- # Creating a new fields group URL: https://wpusermanager.com/article/148-creating-a-new-fields-group/ Last updated: 2019-09-02 In some cases you might want to create a new fields group to split fields into different groups. Field groups are displayed one after the other into the profile page. The account page however, will display a separate new tab for each group that you have created. ### Account page: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2db04286350aeeb530c/5d6cf2d513063.png) As you can see in the image above, the account page now displays a new tab called "Custom fields" this is the name I have given to a group I have created through the custom fields addon. Once clicked, the new tab will display the fields from that group only. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2dc04286350aeeb530d/5d6cf2d57ed71.png) ### Profile page: The profile page instead will display all groups together but separated by their name and/or description. ### How to create a new group: To create a new group navigate to "Users -> custom fields" in your WordPress dashboard and press the "Add new fields group" button. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2dc04286350aeeb530e/5d6cf2d5cc81c.png) Once pressed, a window will appear asking you to add a title and description. Only the title is required. These can always be changed later. Once you have customized the group, press the "Create new fields group" button. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2dc2c7d3a7a4d77f559/5d6cf2d631456.png) Once the group has been created, it'll be added to the lists table from where you can press the "customize fields" button to add fields to that group. --- # Deleting fields and groups URL: https://wpusermanager.com/article/133-deleting-fields-and-groups/ Last updated: 2019-09-02 In some cases you might want to delete individual fields or a whole group. This can be easily done with the click of a button. ### Deleting a field To delete a field click the "delete" button within the fields table. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d02c7d3a7a4d77f53e/5d6cf2c962d67.png) Note: default fields cannot be deleted. When a field doesn't display the "delete" button, it means the field can't be deleted. ### Deleting a group In order to delete a group, click the "Delete group" link within the groups list table. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d02c7d3a7a4d77f53f/5d6cf2c9adfda.png) Note: when deleting a group, all the fields contained within the group will also be deleted and cannot be recovered. --- # URL field type URL: https://wpusermanager.com/article/116-url-field-type/ Last updated: 2021-01-23 The url field type allows the user to enter a URL. The field will automatically output a clickable link into the user profile if displayed. | Available options | description | |---|---| | Placeholder | Customize this setting to show a placeholder | | Nofollow | Enable this option to specify that the search spiders should not follow this link. | --- # Custom fields addon installation URL: https://wpusermanager.com/article/114-custom-fields-addon-installation/ Last updated: 2019-09-02 The following tutorial will guide you through the installation of the WPUM - Custom Fields addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/custom-fields/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-custom-fields. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - Custom Fields in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Number field type URL: https://wpusermanager.com/article/97-number-field-type/ Last updated: 2019-09-02 The number field type allows the user to enter a number. The field will automatically validate whether what's typed into the field is a number or not. | Available options | description | |---|---| | Placeholder | This text will appear within the field when empty. Leave blank if not needed. | | Minimum value | Specifies the minimum value allowed, leave blank if not needed. | | Maximum value | Specifies the maximum value allowed, leave blank if not needed. | --- # Adding custom fields to the registration form URL: https://wpusermanager.com/article/191-adding-custom-fields-to-the-registration-form/ Last updated: 2021-06-19 To add your custom fields to the registration form, please refer to this tutorial --- # Email field type URL: https://wpusermanager.com/article/94-email-field-type/ Last updated: 2019-09-02 The email field type allows the user to enter an email address. The field will automatically validate whether what's typed into the field is an email or not. Note: this field will not change the user's account email address. | Available options | description | |---|---| | Placeholder | Customize this setting to show a placeholder | --- # Checkbox field type URL: https://wpusermanager.com/article/184-checkbox-field-type/ Last updated: 2019-09-02 The checkbox field type allows the user to enable or disable the field. If the user enables the field and saves it's profile, on his public profile page, it will be displayed with a "yes". ##### Example scenario: Field name: Do you have a pet? If the user enabled the checkbox, it means it has a pet and a "yes" will be displayed within it's profile. --- # How to add a US State dropdown field URL: https://wpusermanager.com/article/199-how-to-add-a-us-state-dropdown-field/ Last updated: 2019-09-25 To add a dropdown field that contains the US States, first add a new dropdown field to a field group and edit the 'Unique meta key' setting to **field\_us\_state**. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d8bc4602c7d3a7e9ae1a0ef/file-qbhydz00Bu.png) Then create a new file 'wpum-field-state.php' in wp-content/mu-plugins (you might need to create the directory), and copy and paste the following code: ``` field_meta->get_meta( $object_id, 'user_meta_key', true ); if ( $user_meta_key !== 'wpum_field_us_state' ) { return $check; } $states = array( 'AL' => 'Alabama', 'AK' => 'Alaska', 'AZ' => 'Arizona', 'AR' => 'Arkansas', 'CA' => 'California', 'CO' => 'Colorado', 'CT' => 'Connecticut', 'DE' => 'Delaware', 'DC' => 'District Of Columbia', 'FL' => 'Florida', 'GA' => 'Georgia', 'HI' => 'Hawaii', 'ID' => 'Idaho', 'IL' => 'Illinois', 'IN' => 'Indiana', 'IA' => 'Iowa', 'KS' => 'Kansas', 'KY' => 'Kentucky', 'LA' => 'Louisiana', 'ME' => 'Maine', 'MD' => 'Maryland', 'MA' => 'Massachusetts', 'MI' => 'Michigan', 'MN' => 'Minnesota', 'MS' => 'Mississippi', 'MO' => 'Missouri', 'MT' => 'Montana', 'NE' => 'Nebraska', 'NV' => 'Nevada', 'NH' => 'New Hampshire', 'NJ' => 'New Jersey', 'NM' => 'New Mexico', 'NY' => 'New York', 'NC' => 'North Carolina', 'ND' => 'North Dakota', 'OH' => 'Ohio', 'OK' => 'Oklahoma', 'OR' => 'Oregon', 'PA' => 'Pennsylvania', 'RI' => 'Rhode Island', 'SC' => 'South Carolina', 'SD' => 'South Dakota', 'TN' => 'Tennessee', 'TX' => 'Texas', 'UT' => 'Utah', 'VT' => 'Vermont', 'VA' => 'Virginia', 'WA' => 'Washington', 'WV' => 'West Virginia', 'WI' => 'Wisconsin', 'WY' => 'Wyoming', ); $data = array(); foreach ( $states as $state_abbrev => $state ) { $data[] = array( 'value' => $state_abbrev, 'label' => $state ); } return array( $data ); } ``` --- # Checkboxes & Multi select field types URL: https://wpusermanager.com/article/193-checkboxes-multi-select-field-types/ Last updated: 2019-09-02 The checkboxes and multi select field type allows you to create a field where the user can check/select multiple options. --- # Text & Textarea field types URL: https://wpusermanager.com/article/145-text-textarea-field-types/ Last updated: 2019-09-02 The text and textarea field types allows the user to enter text. The textarea field allows the user to add multiple paragraphs. | Available options | description | |---|---| | Placeholder | Customize this setting to show a placeholder | --- # Delete Account add-on installation URL: https://wpusermanager.com/article/96-delete-account-add-on-installation/ Last updated: 2019-09-02 The following tutorial will guide you through the installation of the WPUM - Delete Account addon. Installation from WordPress.org ------------------------------- Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins” page, inside of your WordPress dashboard, and follow these instructions: 1. In the search field enter “WPUM Delete Account”. Click “Search Plugins”, or hit Enter. 2. Select "WPUM Delete Account" and click either “Details” or “Install Now”. 3. Once installed, click “Activate”. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- To install the addon via FTP - please download it from here first: . This will download a zipped package to your computer. Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-delete-account. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Delete Account in the plugin list. Click the Activate link and you'll be ready to use the plugin. --- # Delete Account: how it works URL: https://wpusermanager.com/article/95-delete-account-how-it-works/ Last updated: 2019-09-02 A new tab called "Delete Account" is added to the account page. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cefa02c7d3a7a4d77f4dc/5d6cef9a0cdb4.png) In order to delete his account, the user will need to type his current password. When the user clicks the "Delete account" button, a confirmation message will appear asking the user to confirm cancellation. Once confirmed, the account, it's data and any submitted posts will then be deleted. --- # Getting Started URL: https://wpusermanager.com/article/285-getting-started/ Last updated: 2021-04-30 This [addon](https://wpusermanager.com/addons/frontend-posting/) allows your users to create content and submit posts from the frontend of your WordPress website. You can create unlimited forms where your users can post different contents. Setting Up a Form ----------------- To set up a form using the Frontend Posting Addon go to your dashboard: 1. Navigate to Users > Post Forms ![](https://lh6.googleusercontent.com/bbUsEPe5RywKafBWVwp3zrq-m-aNeXWK0fDVs0-FHrSIwAneuENrrIDNm4xshVMoA6bPaD-MzTmqoMdd_KLDsbFCJC2N19fJEgkg4OkNfMxYV2t2iGOU1tAeAn4Da2yVxKl_xJjl) 1. Click ‘Add New’ 2. For frontend posting choose ‘Post Form’ and click the ‘Add Form’ button. ![](https://lh4.googleusercontent.com/eUWWYU19gj0D_hu2Gone_7DAglKtVQfnGmfsyBhf0LsVEeJezzKQVpK2gEifDsSR1-8I4rk5RXBMxCwpCdy4X1gO_0k9U6AAGkmW4C7b6e7Q4sjByLbDmNFuzThasPtIIdrkzAAA) 1. In the ‘Post Fields’ menu you can select which fields you want your users to have. 2. You can add more fields from the ‘Fields’ section at the right side of the page. ![](https://lh4.googleusercontent.com/am1IrmJyq5_opZycgl3r22qiiitXLiKsSYVcN7cDuZij2h7WCSmCBB0U-hLvIrEQer2BxCr6srQMU2EaMmmOqB_Cm8wV6g44SpEgpKQ5jXPn0YkyPNchASua3XZzFIEzZpP-9CDU) 1. You can also change the settings of each fields by clicking the edit icon or the ‘Settings’ section at the right side of the page. 2. You can edit the field’s ‘Label’, add a ‘Description’ and ‘Placeholder’, and you can also set the field as a required field. 3. Click ‘Save Changes’ to save your settings. ![](https://lh3.googleusercontent.com/PeZyIAjsVJXbHeYfNEO-thYB91qoJQNWv6D3cLwJDPzSM5DeidEHHY2DJntdYuLRAcYzBP9jyMo8XHmm0l6M5cv_vCHqB6ytrtc1FGhqhU42x_tbsrJwAsBhALoUCDzRxrKFJ0sm) ### Post Settings You can decide how your user frontend post will appear on your site in the Post Settings. 1. Click the ‘Settings’ menu to open the settings for your frontend post form. 2. You can choose the settings you want for your users to include the post’s type, status, format, category, and other form setting options. 3. Click ‘Save Changes’ to save your settings. ![](https://lh4.googleusercontent.com/Ej7AEx5etGu7uMbHZ0XzO8QTIY9iRMW7uXWkDFIxUuMWb39MTNNkOT9hImaSjxG355Y-cLr-X4gMNy5yAm7_xI-ck5L_4gF4pMZfH2Y8pJYGjbVZI9bjQih5Z7gJMVoYJSzodAgG) ### Submission Settings You can decide how your users can submit their posts in your site with the Submission settings. 1. Click the ‘Submission’ menu at the upper right side of the page. 2. Turn-on the ‘Enable Guest Posts’ option to allow your guests to submit posts using your frontend form. 3. You can also ‘Require Gest Details’ when they are posting. ![](https://lh6.googleusercontent.com/LXD9fzhwfnMSmpQs5m-2QqgGf_WMJJDwWnWcFyIJ56iIE6gSoBKgQCa8JA5rl3UDRaCiJwyOJx7hTXgk8wQOJEA9yUvdSZ5Vo6ybx28UcMs2j24vKTzJrE2qOvWYce0fM7w9z0Dj) ### Redirect Settings On the redirect settings, you can decide what page will appear on the user’s screen after creating a frontend post on your site. 1. Click the drop-down menu in the ‘Redirect After Submission’ option. 2. You can choose either to redirect your users to their ‘Created Post’, to a ‘Form Page’, a ‘Page’, or a ‘Custom URL’ that you create for your users. 3. If you select to redirect your users to their ‘Created Post’, the users will be redirected to the page where their contents are posted. ![](https://lh5.googleusercontent.com/-dhdc7dCTAtHg6iqdFr8eioktZq86MpYQ0hcCL9SZALcTDq55soB5qj5FKS_Dfy7TAApjU3tCSgIF65fvJN5IwRCa_FmqWqPiwJUpGmrra-Ss7L7vxsbLZ9-pYSIMqnYBRQeWFDX) 1. If you choose to redirect your users to a ‘Form Page’, you will have to place a message that will appear on your users’ screen after submitting their posts. ![](https://lh4.googleusercontent.com/76xtNsj5ghFaqHC9IYPUEgYLiz2C5fWeFI1bk4SAFp0NmJrC00YwPeTdoNPtoR-0P_OieHuvxv4d8y3DWaLOYqtY6T-nxPWUsQRtkG5xQFn9ghfHwCxkkkIFv6KpeOBG6M4ZgiY5) 1. If you choose to redirect your users to a ‘Page’ on your site after submitting their posts, you have to choose from existing pages on your site where you want your users to be redirected. ![](https://lh3.googleusercontent.com/6m_7VDCaU80V3qyHIPBxk0kUAE-37HIdwiI4LIhHf5fB5_aHbf5VXNaaO8yoFmTaJlbw53MzytsfvNUhyOY_BlUrks32w901aw57rpJ62R0fCx8NZhHEVc-418fC30qhtpLQH0w-) 1. If you choose to redirect your users to a ‘Custom URL’, you need to provide the URL where you want your users to be redirected after submitting their posts. 2. Click ‘Save Changes’ to save your settings. ![](https://lh3.googleusercontent.com/pcIfEoPdEGdLUXTRLI_9ZjuG7vIQFl7w-ZCDOAM56S7EH-uqWjfrI1AdlYpRQLndEYQ3o_SGvSD7K5bW6sdMpVlNxnfBHDbBkijDz3erSEwOaX9KDp-nXtOiCZRL0FDbl-Gr3WKW) 1. On the ‘Form’ menu you will be asked to provide the ‘Form Name’ for your frontend form. 2. Click ‘Save Changes’ to save your settings. ![](https://lh4.googleusercontent.com/QyLLGo7VXqIsm0s697M0HGa8NFv4TtcT3_8JscoRNzcck6nIQtN7XQliFaNyRm8BN3KufKD8ds9bKR4dZPZcjGaJUfPL94Vm9-I7RpO-cPKiOkOtoA_el-JhqSFmssghRYsmsUl5) Creating a Frontend Posting Page -------------------------------- You need to create a page where your users’ frontend posting will be placed. But first you need to copy the shortcode of the frontend form that you created. To do that go to your dashboard: 1. Navigate to Users > Post Forms. 2. Copy the Shortcode of the frontend form that you created. ![](https://lh6.googleusercontent.com/6xJ-bZ29-0Pa010vBTIzJAPTXbpIM2jE1dRMcJi03UmvKxMrUlrGtdRM0M2m2q4QeFriLw3vmfm8XrF8BjgE7WP44OOpYHqbkToxzfc0JHey1oqKdaT4aisCaRaKHcIR8AtcgoDP) 1. Navigate to ‘Pages’ then click ‘Add New’. ![](https://lh3.googleusercontent.com/_VrHp1SQ-qb8jZnRrVkCmhO6aQzopeYmzsJy0cgpPub3r_Q5MpkNnU7RUjRMb1sZN_9lDnpHklsmWTTXSqftMJQe2rCrFMFczRiGCR3wbHj0CiRmizqCETVOh5BMN3UQpzU5LFxp) 1. Add a Title on your page and paste the ‘Shortcode’ of your frontend form at the block below the Title. ![](https://lh3.googleusercontent.com/Wu41fTNqxDurFASlGBiHEbJ8RwWP0URCLzGZWGIMGziJZ6-6oTo0VdzaatCXJGtl_h_7LcJBTAR4Q4aphObv1XV2EnCfnIyYdB_43SRlyCCzPQRy7QI_bYOT7digYc-82JjV2mBi) 1. Set the ‘Visibility’ option to ‘Public’. 2. You can also edit how your page will appear on your website. 3. Once you're done with your settings, click the ‘Publish’ button to publish your page on your site. ![](https://lh3.googleusercontent.com/XyPkLGEyYLO50vmY7gRYRArW-gNay-cXYc8CCwpQVeH5SqsOoVpnmfG2j-aOcdBacvat9WByrRgxXNTCihBO2_v9g3EE5a1UbNhQm0sKv1KN2QO2Xn1Aid12Evb4_BPp1Z-gKiD4) 1. You can make your page appear together with the menu on your website. Just go to your dashboard, navigate to Appearance > Menu. 2. Select the page you created for your frontend posting, click ‘Add to Menu’ and the page will be added to the Menu on your website. 3. Click the ‘Save’ menu to sage your settings. ![](https://lh3.googleusercontent.com/8G8s37tsIQVzvC6qgKPFPRI4qoRO1rIHOe1wESo9_eqMnxJLg_GkbIST24i2bn9fnsEMq0T2NvOhIP7J9sAnWB4LSDjUAUMTcqHCi1gLhMZZ8b9bpCD736TlDE-L10WmHjA2I_gd) Frontend Posting Preview ------------------------- After setting up the form and creating the page for frontend postings, your users can now create and submit their content on your website. 1. To preview your frontend posting page and form go to your site and click the page you created for frontend posting. 2. The ‘Frontend Posting Form’ that you created will appear on the page and your users can now create and submit their posts. ![](https://lh3.googleusercontent.com/hoqZsWIcq1PhAbYgKMp63Q2cpqYa1rrgWOyY74X9tYU99gmSVcqMCDArB41JHZpw0JeUvr9ixkTcZOTgW13e8J_7hTwPQFyr3cBS_4f3qrjbLNZh-_ClFbyxjtBd9fqCuUmqdrEq) --- # Frontend Posting Installation URL: https://wpusermanager.com/article/278-frontend-posting-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM Frontend Posting addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/frontend-posting/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-frontend-posting. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Frontend Posting in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Google reCAPTCHA Installation URL: https://wpusermanager.com/article/164-google-recaptcha-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM - Google reCAPTCHA addon. Installation from WordPress.org ------------------------------- Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins” page, inside of your WordPress dashboard, and follow these instructions: 1. In the search field enter “WPUM - reCAPTCHA”. Click “Search Plugins”, or hit Enter. 2. Select "WPUM - reCAPTCHA" and click either “Details” or “Install Now”. 3. Once installed, click “Activate”. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- To install the addon via FTP - please download it from here first: . This will download a zipped package to your computer. Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-recaptcha. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - reCAPTCHA in the plugin list. Click the Activate link and you'll be ready to use the plugin. --- # Generate reCAPTCHA API keys URL: https://wpusermanager.com/article/147-generate-recaptcha-api-keys/ Last updated: 2020-11-18 Google reCAPTCHA is a free service from Google that stops spams registrations and login attempts on your site. Protecting login and registration forms on your WordPress site is important, especially when using a plugin like [WP User Manager](https://wpusermanager.com/) to allow users to register and sign up from the frontend of the site. The WP User Manager [reCAPTCHA addon](https://wpusermanager.com/addons/recaptcha/) is the simplest way to add reCAPTCHA to your WordPress forms. WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. To use reCAPTCHA you must generate api keys from the Google's recaptcha website. Api keys are free. 1. Navigate to the recaptcha website 2. Click on the "Get reCAPTCHA" blue button in the top right corner of your screen. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2da04286350aeeb5307/5d6cf2d39e51d.png) 3. You are now required to login with your Google account, if you do not have one, register for a free account. 4. Once you're logged in with your Google account, you will be presented with an interface to generate api keys for your website ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2da04286350aeeb5308/5d6cf2d3dee26.png) Register your website --------------------- - In order to register a website, simply type anything into the "label" field of the form. For example you can type the name of your website. - Type your website domain into the "Domains" field of the form, like displayed above. - Enter your email address into the "owners" area of the form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2da04286350aeeb5309/5d6cf2d42bac8.png) Once you've filled the whole form, press the "Register" button. If everything is correct, you will be redirected to a new page with your new api keys ready to be used. Take note of the site key and secret key: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2db04286350aeeb530a/5d6cf2d471db5.jpeg) Find out more about [adding Google reCAPTCHA to your WordPress site](https://wpusermanager.com/tutorials/how-to-easily-add-google-recaptcha-to-wordpress-step-by-step/) with WP User Manager. [Get started with protecting your WordPress site with Google reCAPTCHA.](https://wpusermanager.com/pricing/) --- # Configure reCAPTCHA URL: https://wpusermanager.com/article/92-configure-recaptcha/ Last updated: 2023-09-11 Now that you [have generated your reCAPTCHA api keys](https://wpusermanager.com/article/147-generate-recaptcha-api-keys/), you will need to save them into the WPUM plugin settings panel. 1. Navigate to "Users -> Settings -> General -> reCAPTCHA" 2. A new section will appear asking you for the reCAPTCHA api keys - like displayed into the screenshot below 3. Copy and paste the api keys you have previously generated into the respective settings "site key" and "secret key". Note, if you select v3, you will have to utilize your v3 keys as well. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/64fed762f15ed05267de56e5/file-yfxstCWWNg.jpg) Once you're done, press the "save changes" button. If you've done everything correctly you should see a recaptcha field at the bottom of the forms: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cef9f2c7d3a7a4d77f4da/5d6cef98bd557.png) --- # Restricting content to group members URL: https://wpusermanager.com/article/347-restricting-content-to-group-members/ Last updated: 2026-10-07 There are two ways to keep content for the members of particular groups: a shortcode for part of a page, and the Content Restriction addon for whole posts and pages. Only approved members count: people who are pending approval or invited don't get access. Part of a page: the shortcode ----------------------------- Wrap the content in `[wpum_restrict_to_user_groups]`, with the IDs of the groups that can see it: ``` [wpum_restrict_to_user_groups groups="12,34"] This is only for members of group 12 or group 34. [/wpum_restrict_to_user_groups] ``` Being a member of any one of the listed groups is enough. You'll find a group's ID in the URL when you edit it in the dashboard (`post.php?post=12`). Everyone else sees "This content is available to members only. Please login or register to view this area." To show nothing instead, add `show_message="no"`. In the classic editor, the WPUM shortcode button has a **Specific groups only content** option that builds the shortcode for you. Developers can change the message with the `wpum_content_restriction_message` filter. Whole posts and pages: the Content Restriction addon ---------------------------------------------------- With the [Content Restriction addon](https://wpusermanager.com/addons/content-restriction/) (paid) active, the restriction settings on posts, pages and custom post types have two more options: - **Restriction by Group Membership**: the groups whose members can see the content. - **Group Roles**: limit it further to members with a group role (Member, Moderator or Admin). Leave it blank for any role. Related: [Getting started with the Groups addon](https://wpusermanager.com/article/247-getting-started-with-the-groups-addon/). --- # Inviting members to a group URL: https://wpusermanager.com/article/345-inviting-members-to-a-group/ Last updated: 2026-10-07 This needs Groups 1.3.0 or later. You can invite people to a group instead of adding them straight away. Each person gets an email with a link, and they become a member when they follow it. Until then they're listed as **Invited**: they aren't counted as members, and they can't see a hidden group. There are three ways to invite someone. From the group editor (hidden groups) ------------------------------------- 1. Go to **User Groups** and edit the group. Its privacy must be **Hidden**. 2. In **Add New Members**, pick the users to invite. 3. Tick **Invite user to Group** below the list. 4. Click **Update**. The users you picked are emailed an invitation instead of being added. The box only shows while the privacy is Hidden, and it only applies to that save: next time you add members they're added straight away unless you tick it again. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac633ed7296b2aaabcbde0b/02-editor-invite-box-c6012476.png) From the Edit User screen (any group) ------------------------------------- 1. Go to **Users** and edit the user. 2. In the **Groups** section, choose a group under **Invite to group**. 3. Click **Update User**. The dropdown lists every group the user isn't already in, hidden ones included. The same section shows the groups they're a member of. You need to be able to promote users (administrators can) to see it. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac633fd5d694b44a06b9ce3/03-edit-user-groups-007e6b33.png) From the group page (group admins of hidden groups) --------------------------------------------------- Group admins of a hidden group see an **Invite members** box at the top of the group's **Members** tab. 1. Enter usernames or email addresses, one per line or separated by commas. 2. Click **Send invitations**. The page then says how many invitations were sent, and how many couldn't be: either there's no account with that username or email, or the person is already in the group. Up to 20 people can be invited at a time. Below the box, **Waiting to accept** lists everyone who hasn't accepted yet. Only people who already have an account on your site can be invited. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac633fece7c1db042bc87a2/01-invite-members-tab-b48c7f36.png) Accepting an invitation ----------------------- The email has a link to accept. When the invited person follows it: - If they're logged in, they join the group and land on the group page. - If they're logged out, they're sent to the login page first, then join. - If someone else is logged in, they see an error: the link only works for the person who was invited. Links expire after a week. To send a new one, invite the person again: the new link replaces the old one. An invited user can also accept by clicking **Join** on a public or private group's page, where they'll see "You have been invited to join this group. Click Join to accept." The invitation email -------------------- Edit the email under **Users > Emails > Group invited**. It must include the `{group_join_url}` tag, which is the accept link. Other useful tags are `{group}` and `{username}`. For developers -------------- - `wpumgp_invite_user_to_group( $group_id, $user_id )` invites a user and sends the email. - `wpumgp_invitation_key_lifetime` filters how long links last, in seconds (default one week). - `wpumgp_max_invitations_per_submit` filters how many people a group admin can invite at once (default 20). - `wpumgp_can_invite_from_group_page` filters who sees the Invite members box. - `wpumgp_user_after_invitation` and `wpumgp_after_invitation_accepted` fire after an invitation is sent and accepted. Related: [Moderating group members](https://wpusermanager.com/article/251-moderating-group-members/), [Managing group members](https://wpusermanager.com/article/346-managing-group-members/). --- # Managing group members URL: https://wpusermanager.com/article/346-managing-group-members/ Last updated: 2026-10-07 Site admins manage members from the dashboard, and group admins from the group page. In the dashboard: the group editor ---------------------------------- Go to **User Groups** and edit the group. - **Add members:** pick users in **Add Members** (in the **Add New Members** box) and click **Update**. They're added as approved members straight away. On a hidden group you can invite them instead; see [Inviting members to a group](https://wpusermanager.com/article/345-inviting-members-to-a-group/). - **Change a member's role:** the **Members** box lists everyone in the group with the date they joined, their role and status. Change the **Role** dropdown (Member, Moderator or Admin) and click **Update**. - **Remove a member:** click **Remove** in their row. - **Approve or reject** a pending member of a private group: click **Approve** or **Reject** in their row. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634005d694b44a06b9ce4/05-members-box-232e34ba.png) In the dashboard: the Users screen ---------------------------------- Under **Users**, a **Group** column shows the groups each user is in (up to five, then "& N more"). To add several users to a group at once: 1. Tick the users. 2. Choose the group in the **Add to Group…** dropdown above or below the table. 3. Click **Apply**. They're added as approved members, and anyone already in the group is skipped. This needs permission to promote users (administrators have it). The dropdown lists public and private groups. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634015d694b44a06b9ce5/04-users-screen-bulk-add-e98e91ce.png) On the group page ----------------- Group pages have tabs. Everyone sees **About** and **Members**. Moderators and admins also see **Moderation**, and admins see **Tools**. - **Remove a member:** group admins see a **Remove** button next to each member on the **Members** tab. - **Export the members:** on the **Tools** tab, **Export** downloads a CSV of the group's members with their email address, first name and last name. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634025d694b44a06b9ce6/06-tools-export-6643468e.png) The Members tab respects each member's profile privacy settings: members whose profiles the visitor isn't allowed to see aren't listed. When a user is deleted ---------------------- Deleting a user removes them from all their groups. For developers -------------- - `wpum_groups_add_user_to_group_cap` filters the capability for bulk adding (default `promote_users`). - `wpum_groups_total_group_displayed` filters how many groups the Group column shows (default 5). - `wpum_prepare_csv_header`, `wpum_prepare_member_data`, `wpum_group_prepare_csv_members` and `wpum_group_csv_filename` customize the export. Related: [Moderating group members](https://wpusermanager.com/article/251-moderating-group-members/), [Editing a group](https://wpusermanager.com/article/252-editing-a-group/). --- # Allow users to join groups from the registration forms URL: https://wpusermanager.com/article/289-allow-users-to-join-groups-from-the-registration-forms/ Last updated: 2026-10-07 New users can join public groups as they register. 1. Go to **Users > Registration Forms**, edit the form, and open its **Settings**. 2. Turn on **Allow Users to Join User Groups** (the name follows your group name; see [Changing the name of the group object](https://wpusermanager.com/article/248-changing-the-name-of-the-group-object/)). 3. Save. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6121fcde6ffe270af2a9af67/file-w7Ypftachh.png) The form then lists your public groups as checkboxes. The groups a new user ticks are joined straight away when they register. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6121fd4f21ef206e5592d934/file-7QteSizmlc.png) Mentioning the groups in emails ------------------------------- The `{joined_groups}` tag lists the groups picked on the registration form, for example in the registration confirmation email. For developers -------------- - `wpum_groups_registration_form_field_label` filters the field's label. - `wpum_groups_registration_form_field_description` filters the text under it. (Before Groups 1.3.0 the description filter also changed the label. If you used it for the label, move that to the label filter.) --- # Displaying a directory of groups URL: https://wpusermanager.com/article/250-displaying-a-directory-of-groups/ Last updated: 2026-10-07 Show a directory of your groups anywhere with the `[wpum_group_directory]` shortcode. It lists public and private groups; hidden groups are never listed. Shortcode options ----------------- - `per_page`: how many groups to show per page, with pagination for the rest. Default 10. - `has_search_form`: show the search form and filters. Default `true`. - `show_public`: include public groups. Default `true`. - `show_private`: include private groups. Default `true`. For example, a directory of private groups only, 20 per page: ``` [wpum_group_directory per_page="20" show_public="false"] ``` In the classic editor, the WPUM shortcode button has a **Group Directory** option that builds the shortcode for you. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f82af8ccff47e001a58d409/file-mpEryXOKHG.png) What visitors see ----------------- - **Search** by group name, and **filter** by category and tag. - Each group's privacy, number of members, and a **Join** or **Leave** button for logged-in users. - Logged-in users also get **All Groups** and **My Groups** buttons with counts, to switch between every group and the ones they're in. - Users who can create groups get a **Create a Group** link. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634115d694b44a06b9ce8/07-directory-7c750344.png) --- # Moderating group members URL: https://wpusermanager.com/article/251-moderating-group-members/ Last updated: 2026-10-07 When someone asks to join a **private** group, they're added as pending. They aren't a member until a group moderator or admin approves them. (Public groups don't need approval. Hidden groups can't be joined by asking: people are added or invited.) Group roles ----------- - **Admin:** can edit the group, remove members, export the member list, invite people to hidden groups, and approve or reject requests. - **Moderator:** can approve or reject requests. - **Member:** a member of the group. When someone asks to join ------------------------- The group's moderators and admins are emailed. Edit that email under **Users > Emails > New Group pending member**; the `{group_approval_url}` tag links to the group's Moderation tab. Approving or rejecting on the group page ---------------------------------------- Moderators and admins see a **Moderation** tab on the group page (nobody else does). It lists everyone waiting, with **Approve** and **Reject** links. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634135d694b44a06b9ce9/08-moderation-tab-655a9f5f.png) The person is emailed either way. Edit those emails under **Users > Emails > Group membership approved** and **Group membership rejected**. Moderators can only approve or reject members of groups they moderate. Approving or rejecting in the dashboard --------------------------------------- Site admins can do the same when editing the group under **User Groups**: pending members in the **Members** box have **Approve** and **Reject** links. See [Managing group members](https://wpusermanager.com/article/346-managing-group-members/). ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6ac634005d694b44a06b9ce4/05-members-box-232e34ba.png) For developers -------------- The `wpum_group_admin_email_pending_member` filter turns off the email to moderators (return `false`). --- # Getting Started with the Groups Addon URL: https://wpusermanager.com/article/247-getting-started-with-the-groups-addon/ Last updated: 2026-10-07 The Groups addon lets you and your members create groups, join them, and keep content for the people in them. Group privacy ------------- Each group is one of three kinds: - **Public:** anyone can see the group, and any logged-in user can join straight away. - **Private:** anyone can see the group and ask to join, but a group moderator or admin has to approve them. See [Moderating group members](https://wpusermanager.com/article/251-moderating-group-members/). - **Hidden:** only members can see the group, and it isn't listed in the directory. People join when a site admin adds them, or when they accept an invitation. See [Inviting members to a group](https://wpusermanager.com/article/345-inviting-members-to-a-group/). Group roles ----------- Members of a group have one of three roles: - **Admin:** edits the group, removes members, invites people to hidden groups, exports the member list, and approves or rejects requests to join. - **Moderator:** approves or rejects requests to join. - **Member:** belongs to the group. Whoever creates a group from the front end becomes its admin. Site admins change roles in the dashboard; see [Managing group members](https://wpusermanager.com/article/346-managing-group-members/). Where groups appear ------------------- - **Group pages** have an About tab and a Members tab, plus a Moderation tab for moderators and admins, and a Tools tab for admins. - **The group directory** lists public and private groups: see [Displaying a directory of groups](https://wpusermanager.com/article/250-displaying-a-directory-of-groups/). - **Profiles** get a Groups tab listing the groups the user belongs to. On your own profile it includes hidden groups. Next steps ---------- - [Creating a new group](https://wpusermanager.com/article/249-creating-a-new-group/): by site admins, or from the front end by users with the right role - [Editing a group](https://wpusermanager.com/article/252-editing-a-group/) - [Inviting members to a group](https://wpusermanager.com/article/345-inviting-members-to-a-group/) - [Managing group members](https://wpusermanager.com/article/346-managing-group-members/) - [Restricting content to group members](https://wpusermanager.com/article/347-restricting-content-to-group-members/) - [Allow users to join groups from the registration forms](https://wpusermanager.com/article/289-allow-users-to-join-groups-from-the-registration-forms/) - [Changing the name of the group object](https://wpusermanager.com/article/248-changing-the-name-of-the-group-object/): if "Group" doesn't fit your site, call them teams, clubs or organizations instead --- # Creating a new group URL: https://wpusermanager.com/article/249-creating-a-new-group/ Last updated: 2026-10-07 In the dashboard ---------------- Site admins create groups under **User Groups > Add New**. A group has: - **Title** and **content** (shown on the group's About tab) - **Featured image** - **Categories** and **tags** (used by the directory filters) - **Privacy**: Public, Private or Hidden, in the **Group Settings** box - **Add Members**: users to add straight away (or, on a hidden group, to invite) ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f8237f4c9e77c0016216941/file-nwcqFnJr3Z.png) From the front end ------------------ Users whose role is in **Allow users to create Groups** (under **Users > Settings > Groups**) can create groups from the site. By default that's administrators only. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f82385352faff0016aeeba0/file-aiHmyMQkWa.png) They'll see a **Create a Group** link above the group directory, and a **Create Group** button on the Groups tab of their own profile. Both go to `yoursite.com/groups/new/`, where "groups" is the plural name set in the settings. Logged-out visitors are sent to log in first. The form has: - **Name** (required) - **Description** - **Image**: JPG or PNG - **Category** - **Tags**: one per line - **Privacy**: Public, Private or Hidden ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f823a65c9e77c0016216944/file-RUfYZwR5qZ.png) The person who creates the group becomes its admin. If something's wrong (for example an image that isn't a JPG or PNG), the form shows the error and nothing is created. --- # Changing the name of the Group object URL: https://wpusermanager.com/article/248-changing-the-name-of-the-group-object/ Last updated: 2026-10-07 "Group" is a general term that might not fit your site. If your members join organizations, teams or clubs, use that name instead. Go to **Users > Settings > Groups** and set: - **Group Singular Name**, for example "Team" - **Group Plural Name**, for example "Teams" ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f823769cff47e001a58d3bd/file-JgnNCr8rMK.png) The names are used across the site and the dashboard: - group pages move to `yoursite.com/team//` - the front-end create form moves to `yoursite.com/teams/new/` - the profile tab, the directory buttons, the emails' names and the dashboard menu use the new names After changing the names, go to **Settings > Permalinks** and click **Save Changes**, so WordPress picks up the new URLs. --- # Groups Installation URL: https://wpusermanager.com/article/242-groups-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM Groups addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/groups/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-groups. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Groups in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Editing a Group URL: https://wpusermanager.com/article/252-editing-a-group/ Last updated: 2026-10-07 Group admins, from the group page --------------------------------- Group admins see an **( Edit group )** link next to the group's name. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f82b5d246e0fb001798bc7b/file-zIqG35t6ej.png) It opens the **Edit** tab with the same form used to create a group: name, description, image, category, tags and privacy. Change what you need and click **Update Group**. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f82b601cff47e001a58d40e/file-155QufAiSI.png) To remove the group's image, click **\[remove\]** next to it before updating. Only the group's admins see the link and the form. Site admins, in the dashboard ----------------------------- Site admins can edit any group under **User Groups**, including its members: see [Managing group members](https://wpusermanager.com/article/346-managing-group-members/). --- # hCaptcha Installation URL: https://wpusermanager.com/article/316-hcaptcha-installation/ Last updated: 2022-12-18 The following tutorial will guide you through the installation of the WPUM hCaptcha addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/hcaptcha/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-hcaptcha. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM hCaptcha in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Generate hCaptcha API keys URL: https://wpusermanager.com/article/317-generate-hcaptcha-api-keys/ Last updated: 2022-12-18 hCapcha is a free service from that stops spams registrations and login attempts on your site. Protecting login and registration forms on your WordPress site is important, especially when using a plugin like [WP User Manager](https://wpusermanager.com/) to allow users to register and sign up from the frontend of the site. The WP User Manager [hCaptcha addon](https://wpusermanager.com/addons/hcaptcha/) is the simplest way to add a captcha to your WordPress forms. WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. To use hCaptcha you must generate api keys from the hCaptcha website, signup is free 1. Navigate to the hCaptcha website 2. Sign up with your details Register your site - On the dashboard click ['New Site'](https://dashboard.hcaptcha.com/sites/new) - Add a name for the site - Add your site domain in the Hostnames field, including any development local URLs for you site - Select the 'hCaptcha Behavior' and 'Passing Threshold' - Click 'Save' at the top of the form ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/639f9313816c5914d3b2cf87/file-gkYeDnj0bn.png) Once you've saved the site, you can edit the site and grab the 'Sitekey': ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/639f936f8527f140b63eda9f/file-wYcih8SBXr.png) The site key is used alongside the account secret key, found in your [account settings](https://dashboard.hcaptcha.com/settings), in the plugin settings in your site's admin in Users > Settings > hCaptcha. --- # Custom Queries by Likes URL: https://wpusermanager.com/article/324-custom-queries-by-likes/ Last updated: 2023-01-02 Although the data for all the user likes is stored in a custom table, the count of likes for each post is stored in post meta with the key 'wpum\_likes'. This makes it easy to query and sort posts using the [WP\_Query](https://developer.wordpress.org/reference/classes/wp_query/) function. For example, you can get all posts ordered by those with the most likes with this code: https://gist.github.com/wp-user-manager/cc6f354876b1a7716e22ef393592d119 --- # Showing User Likes in the Profile URL: https://wpusermanager.com/article/321-showing-user-likes-in-the-profile/ Last updated: 2023-01-02 It is possible to display all the content (posts, pages, and custom post types) a user has liked on their profile page. Enable the 'Display Likes' setting in Users > Settings > Profiles > Profiles Content: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63b33be2a5e796606e89ef82/file-c2oOfWPpeI.png) You can also customize the name of the tab for the Likes tab on the profile with the 'Like Tab Name' setting as well as the 'wpum\_likes\_profile\_tab\_name' filter. The slug is generated automatically from the name, but can be overridden with the 'wpum\_likes\_profile\_tab\_slug' filter. Profile Permissions ------------------- By default, only users can access the Likes profile tab to see their own liked content. You can allow users to view the Likes profile tab for other users with the 'Allow Members to View Likes' setting via Users > Settings > Profiles > Permissions. This will only show if the 'Allow Members to View Profiles' setting is turned on. You can also allow guests (visitors who aren't logged in) to view the Likes profile tab for users with the 'Allow Guests to View Likes' setting via Users > Settings > Profiles > Permissions. This will only show if the 'Allow Guests to View Profiles' setting is turned on. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63b33d3a5e3dc13d05544904/file-kQ6wt8YnQg.png) --- # Customizing the Templates URL: https://wpusermanager.com/article/323-customizing-the-templates/ Last updated: 2023-02-17 A lot of times when building a site or theme with WP User Manager, you will want to customize the template of the like button or the profile tab likes content. Luckily WPUM allows you to do this and it's very easy to do. First of all, you should learn how the template system works. Read more information in this article: Now that you learned how to override the templates, we will have a look at which templates are used by the user directory. Like Button ----------- templates/likes/button.php The button.php file, is the template file responsible for rendering the Likes button and showing the current count of likes. The structure of the HTML is an anchor with a specific class and data attribute, as well as child span elements with classes, both will need keeping in any custom HTML your write. Profiles Tab Content -------------------- templates/profiles/likes.php The likes.php file, is the template file responsible for rendering the liked content of a user on their profile page. --- # Functions URL: https://wpusermanager.com/article/322-functions/ Last updated: 2023-01-02 The WP User Manager Likes addon has some functions that can be used in templates to access certain data. **wpumli\_get\_likes\_count( $post\_id )** This function will return the number of likes a piece of content has, when supplied with the ID of that post, page or custom post type. **wpumli\_get\_likes\_by\_user( $user\_id, $post\_type = null )** This function will return an array of post IDs for the content a user has liked. You can optionally pass a post type string to only get the likes for a specific post type. **wpumli\_get\_users\_who\_liked\_post( $post\_id )** This function will return an array of user IDs who have like a piece of content. **wpumli\_get\_liked\_posts\_for\_profile( $user\_id, $post\_type = null )** This function returns the liked content for a user and is used to render the profile content on the Likes tab. It is pluggable so you can overwrite this function in your own code. --- # Gettting Started with the Likes Addon URL: https://wpusermanager.com/article/320-gettting-started-with-the-likes-addon/ Last updated: 2023-01-02 The Likes addon for WP User Manager allows users to like post, pages or other custom post types. The liked content can be displayed on the users profile. There are three different ways to show the Like button and likes count on a piece of content. Automatically at the End of Content ----------------------------------- If you have certain post types that you will always want to display the Like button for, you can set these post types in the Users > Settings > General > Likes settings screen: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63adb6109ef7901532ad2f28/file-AUu1LRJHYp.png) ------------------------------------------------------------------------------------------------------------------------------------ With a Block ------------ If you are using the block editor you can use the Like Button block to add the button wherever you need within your content: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/63b33a72f439e8768b4f6fd5/file-B71WLihqOI.png) With a Shortcode Alternatively, you can specify where the like button goes with the `[wpum_like_button]` shortcode. --- # Likes Installation URL: https://wpusermanager.com/article/319-likes-installation/ Last updated: 2022-12-27 The following tutorial will guide you through the installation of the WPUM Likes addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/likes/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-likes. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Likes in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Subscribing a user to a Mailchimp list on registration URL: https://wpusermanager.com/article/286-subscribing-a-user-to-a-mailchimp-list-on-registration/ Last updated: 2021-05-05 Getting your users who register on your WordPress site into your Mailchimp audience can be achieved with the WP User Manager registration forms and [Mailchimp addon](https://wpusermanager.com/addons/mailchimp/). Once the Mailchimp addon has been [downloaded and installed](https://wpusermanager.com/article/149-mailchimp-addon-installation/), navigate to Users > Mailchimp to see the settings. You will need to enter your [Mailchimp API key](https://mailchimp.com/help/about-api-keys/) and save the changes to the access your lists. Click 'Add List' to connect one of your Mailchimp lists (know as audiences in Mailchimp) to WP User Manager: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6092ce608af76a714bfde43a/file-6Sv6aEsRgM.png) You can then choose how new users will be added to that list when they register on your site. The optin method has two options: 1. Automatically add users to a Mailchimp list when they register. 2. Allow users to opt-in to subcribing to a Mailchimp list when they register. If you choose the second option, a checkbox will appear on your registration form to allow the users to confirm subscription: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6092cf9d8996210f18bda738/file-3iEnvkV0ss.png) You can customize the text used for the confirmation checkbox in the list settings: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6092cfc0f8c0ef2d98df9838/file-llu5xpoRvA.png) If you have multiple lists connected, you can allow you users to choose between them at registration time: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6092cff18996210f18bda73a/file-9dKbTjgo0T.png) --- # Mailchimp Addon Installation URL: https://wpusermanager.com/article/149-mailchimp-addon-installation/ Last updated: 2021-05-05 The following tutorial will guide you through the installation of the WPUM - MailChimp addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/mailchimp/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-mailchimp. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - MailChimp in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Mailchimp API Key URL: https://wpusermanager.com/article/120-mailchimp-api-key/ Last updated: 2021-05-05 To use MailChimp you must generate an API key from your MailChimp account and save it into the addon's settings of your WordPress website. 1 Generate an API Key from your MailChimp account - read here how: 2 Login into your WordPress dashboard and navigate to: Users -> Mailchimp and add the API key you've just generated, into the "MailChimp API Key" setting. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c82c7d3a7a4d77f526/5d6cf2c1b4a0a.png) 3 Press the "Save Changes" button. --- # Sync all of your users URL: https://wpusermanager.com/article/119-sync-all-of-your-users/ Last updated: 2026-10-14 The Mailchimp addon can add your existing users to a Mailchimp list (audience), or update their name and merge fields if they're already on it. You can run the sync from your dashboard, or from the command line with WP-CLI. Users who have unsubscribed from a list stay unsubscribed: the sync only updates their details. From your dashboard ------------------- Go to **Users > All Users** and click the **Import to Mailchimp** link above the list of users. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c704286350aeeb52e4/5d6cf2c116030.png) Choose the user role you want to sync and the list to add them to, then click **Sync Users**. Only lists enabled under **Users > Mailchimp** are offered. The sync works through your users 10 at a time and shows its progress, so keep the page open until it says it's complete. If any users couldn't be added, it tells you how many, and Mailchimp's reasons are listed at the top of **Users > Mailchimp**. With WP-CLI ----------- From version 2.1, you can also run the sync from the command line. It suits large sites, and you can schedule it with cron to keep a list up to date: ``` wp wpum mailchimp-sync --list= ``` Options: - `--list=`: the ID of the Mailchimp list, which must be enabled under **Users > Mailchimp**. If you give an ID that isn't enabled, the command lists the enabled lists with their IDs. You can also find it in Mailchimp under the audience's **Settings > Audience name and defaults**. - `--role=`: only sync users with this role, for example `subscriber`. Leave it out to sync every user. - `--batch-size=`: how many users to load from the database at a time. The default is 50. - `--dry-run`: show how many users would be synced, without contacting Mailchimp. For example, to sync everyone with the Subscriber role: ``` wp wpum mailchimp-sync --list=ab12cd34ef --role=subscriber ``` The command shows a progress bar, then how many users were synced. Any that couldn't be are listed at the top of **Users > Mailchimp**. --- # Pass custom fields as merge fields URL: https://wpusermanager.com/article/117-pass-custom-fields-as-merge-fields/ Last updated: 2019-09-02 Note: this functionality requires the purchase of the [Custom Fields](https://wpusermanager.com/addons/custom-fields/) add-on too. You can send custom fields values to your MailChimp lists. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c62c7d3a7a4d77f521/5d6cf2c024936.png) Navigate to Users -> MailChimp and scroll down the page, you'll notice a "Mailchimp custom fields" table where you can configure your custom fields and merge fields. Once merge fields have been loaded, press the **"add entry"** button and configure the custom field and merge field that you want to match. Upon registration and account update, WPUM will send the fields to your MailChimp account. --- # Working with lists URL: https://wpusermanager.com/article/101-working-with-lists/ Last updated: 2019-09-02 The following article will help you understand how to enable/disable and customize the lists from your MailChimp account and get the ready to be used with WPUM. ### Enable & Disable lists WPUM MailChimp is capable of working with one or more lists at the same time. For example, your users can decide to signup to one or more lists. Once you've decided which lists you want to use with WPUM, navigate to ***Users -> MailChimp*** in your WordPress dashboard and locate the **"Enabled Mailchimp lists"** option. There you will see an editor for your lists. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cefa32c7d3a7a4d77f4e3/5d6cef9c96bc8.png) Click the **"Add entry"** button to add a new list. Once clicked, you'll be able to select which list you wish to add and if needed, you can type a custom description for the list. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cefa22c7d3a7a4d77f4e0/5d6cef9b9f76c.png) Press the save changes button once you're finished. ### Customize the lists order If you're using multiple lists, you can also choose to change the order with which they appear on your site. In order to do so, click and then drag & drop the list row. Press the save changes button once you're finished. ### Lists descriptions Sometimes you might want to display a custom description within the form. Each list on your site can have it's own description. Enter the description you wish to display into the "custom list description" setting. Press the save changes button once you're finished. The description will be used in place of the list name within your forms. --- # Retrieving & Updating Lists URL: https://wpusermanager.com/article/99-retrieving-updating-lists/ Last updated: 2019-09-02 Once your MailChimp API keys has been set up, you can start using the addon and retrieve all the lists that you've created on MailChimp. Each time you press the "Save changes" button within the MailChimp settings panel, WPUM will retrieve your lists from MailChimp together with any merge fields available for your lists. Once lists have been retrieved, you can use them within the settings panel. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cefa22c7d3a7a4d77f4e0/5d6cef9b9f76c.png) --- # Automatic account details update URL: https://wpusermanager.com/article/100-automatic-account-details-update/ Last updated: 2019-09-02 Default account information on MailChimp include first name and last name. When a user on your site powered by WPUM, updates his first name and last name, the information will be automatically updated into your MailChimp lists too. This only happens when the user himself updates his account from the frontend. --- # Allow users to manage their subscription status URL: https://wpusermanager.com/article/98-allow-users-to-manage-their-subscription-status/ Last updated: 2019-09-02 Navigate to *Users -> Mailchimp* and enable the "Account subscription" option. Once the option is enabled, a new section will appear within the user's account editing page where he can signup/unsubscribe for one or more lists. --- # My Mailchimp list isn't showing my users URL: https://wpusermanager.com/article/102-my-mailchimp-list-isnt-showing-my-users/ Last updated: 2021-05-05 Sometimes when a user is subscribed or imported into a list, changes aren't instantly visible. You will need to wait a few minutes until MailChimp updates the data into your MailChimp account dashboard. Please wait and check back at a later moment. --- # Personal data add-on: how it works URL: https://wpusermanager.com/article/163-personal-data-add-on-how-it-works/ Last updated: 2019-09-02 The [WPUM Personal data add-on](https://wpusermanager.com/addons/personal-data/) is required for this specific functionality.A new "Personal data" tab is added to the account page. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e52c7d3a7a4d77f570/5d6cf2ded681f.png) The user will be requested to type his current password before requesting an export of data or before requesting erasure of personal data. Upon successful submission, requests will be logged under " **Tools -> Export personal data**" and/or "**Tools -> Erase personal data**" within your admin dashboard from where you can manage requests. This add-on follows the way WordPress itself provides integration for privacy tools. This addon will evolve alongside WordPress when new privacy tools will be introduced. ### Email notifications When requesting an export or erasure of personal data, the user will receive a confirmation request email with a special link that once clicked, will mark the request as confirmed in your dashboard so the administrators can either send an export of data or erase personal data. --- # Personal data add-on installation URL: https://wpusermanager.com/article/118-personal-data-add-on-installation/ Last updated: 2019-09-02 The following tutorial will guide you through the installation of the **WPUM Personal Data** addon. Installation from WordPress.org ------------------------------- Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins” page, inside of your WordPress dashboard, and follow these instructions: 1. In the search field enter “WPUM Personal Data”. Click “Search Plugins”, or hit Enter. 2. Select "WPUM Personal Data" and click either “Details” or “Install Now”. 3. Once installed, click “Activate”. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- To install the addon via FTP - please download it from here first: . This will download a zipped package to your computer. Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-personal-data. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Personal Data in the plugin list. Click the Activate link and you'll be ready to use the plugin. --- # How to change the Private Content profile tab name URL: https://wpusermanager.com/article/245-how-to-change-the-private-content-profile-tab-name/ Last updated: 2020-10-12 The private content only visible to the logged in user on their profile appears on a new 'Private Content' tab: ![](https://wpusermanager.com/content/uploads/2020/10/private-content.png) You can change the name of this tab via Users > Settings > Profiles > Profiles Content, using the 'Private Content Tab Name' setting: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f823364c9e77c001621693c/file-AwZN2ucBCT.png) --- # Getting Started with the Private Content Addon URL: https://wpusermanager.com/article/244-getting-started-with-the-private-content-addon/ Last updated: 2020-10-12 The Private Content addon allows site administrators to provide content that is only visible to users. This can be content that is shown to **all** users, which you can define in Users > Settings > Profiles > Profiles Content: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f8232024cedfd0017dd086a/file-h171Ygy9gC.png) You can also set different content for each user. You can do this buy editing the user in the WordPress admin dashboard. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f82325352faff0016aeeb98/file-2vrDxK96Yg.png) Both these pieces of content will be shown in a 'Private Content' tab on the users profile, but only displayed when the logged in user views their own profile. --- # Private Content Installation URL: https://wpusermanager.com/article/241-private-content-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM Private Content addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/private-content/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-private-content. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Private Content in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # How to display private content anywhere URL: https://wpusermanager.com/article/246-how-to-display-private-content-anywhere/ Last updated: 2020-10-12 By default the private content for a user is displayed on their profile - only visible to them. But you can display this private content anywhere on the site with the \[wpum\_private\_content\] shortcode. --- # How to Create Multi-Step Registration Forms URL: https://wpusermanager.com/article/265-how-to-create-multi-step-registration-forms/ Last updated: 2021-01-23 If you are collecting lots of data from users at registration, with multiple custom fields (created with the [Custom Fields addon](https://wpusermanager.com/addons/custom-fields/)), then you might want to split up the form into different steps, so that users fill out some fields and then click next to move to the next step. For example: ![](https://wpusermanager.com/content/uploads/2021/01/wpum-registration-form-steps.png) To use the multi-step feature you need to have the [Registration Forms addon](https://wpusermanager.com/addons/registration-forms/) enabled. - Navigate to Users > Registration Forms - Click 'Customize Form' for the form you want to add steps to Click 'Add Step' to add your first step: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bf734b9a8501b295d363b/file-DRHT62r7Q7.png) Move that step to the top of the fields. Add further steps as dividers between fields to group them into the steps. You can give the step a name and description which can be displayed on the form: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bf77dcfe30d219ccdacc8/file-CYnL1NyeOn.png) Customize the Form ------------------------------------------------------------------------------------------------------------------------------------------------------ You can customize the how the steps are displayed, click the 'Settings' tab on the registration form: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bf7ff2e764327f87c19f1/file-Zlkbw4UyOy.png) You can turn off the Step title and description from being displayed on the form with the 'Show Step Titles & Description' setting. Turn off the progress bar with the 'Show Step Progress Bar' setting. Turn off the step breadcrumb buttons with the 'Show Step Breadcrumbs' setting. Finally, customize the 'Next' and 'Previous' button labels. --- # Adding different Registration Forms to the site URL: https://wpusermanager.com/article/236-adding-different-registration-forms-to-the-site/ Last updated: 2020-10-01 The Registration Forms addon allows you to create different registration forms so you can register different types of people and collect different data from them. By default the `[wpum_register]` shortcode shows the default registration form. There are three methods to show a different form: Shortcode --------- To specify a different form in the shortcode you can pass it to the `form\_id` parameter `[wpum_register form_id="2"][/wpum_register]` You can find the shortcode on Alternatively, if you are using the Classic Editor in WordPress you can use the WPUM shortcode builder: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f7599cfc9e77c001621359d/file-Um77v1ZcEt.png) Block ----- If you are using the Block Editor then you can make use of the custom WP User Manager block for the registration form, where you can select the form in the block settings: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f75afa746e0fb0017988a45/file-j1aBLiAzD1.png) Widget ------ If you'd like to place the form in a widget-enabled area like a sidebar, then you can use the \[WPUM\] Registration Form widget: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5f75afea4cedfd0017dcd585/file-UN5HgLtizT.png) --- # Registration Forms addon installation URL: https://wpusermanager.com/article/221-registration-forms-addon-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM - Registration Forms addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/registration-forms/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-registration-forms. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - Registration Forms in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Customizing the Registration Forms URL: https://wpusermanager.com/article/233-customizing-registration-forms/ Last updated: 2020-06-22 The Registration Forms editor allows you to add custom HTML to your forms. Underneath the fields in the left hand section of the form editor, is a button to 'Add HTML'. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ef1320e04286306f80599a1/file-t7b9zRkLRD.png) When clicked a modal appears with a rich text editor where you can add HTML that will appear in the form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ef1323304286306f80599a2/file-OHfM95i6sT.png) When saved, the HTML is added underneath the fields on the form. However, these HTML fields can be dragged around and reordered between the existing fields. The HTML is then displayed on the frontend form: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ef132a22c7d3a10cba96233/file-m5hKCPD4wj.png) The HTML fields even support adding shortcodes that will be rendered on the form. --- # Creating an allowed list of emails addresses for registration URL: https://wpusermanager.com/article/308-creating-an-allowed-list-of-emails-addresses-for-registration/ Last updated: 2022-08-07 As an addition to the [Block List feature](https://wpusermanager.com/article/299-how-to-block-sigups-from-specific-email-addresses/) of the [WPUM Security addon](https://wpusermanager.com/addons/security/), there is now a feature that lets you allow the users to register with the email addresses only allowed in the list. You can access it in the WordPress dashboard > Users > Settings > Security tab. ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/xQuw88Kz/5ca5a6d9-5ffb-493a-9602-01350f9a26e5.jpeg?v=163f0d8a22768948f501d91b33c0aad4) This feature allows you to add addresses in full addresses(i.e. test@example.com), domains(i.e. @domain.com), or even partials(i.e. google). You can use a new line to separate and add multiple addresses within it. --- # How to temporarily disable users without deleting them so they can’t login URL: https://wpusermanager.com/article/307-how-to-temporarily-disable-users-without-deleting-them-so-they-can-t-login/ Last updated: 2022-08-07 With the WP User Manager Security addon version 1.3, a new feature was added to disable users even without deleting their account which prevents them from logging in. To do such, proceed in your WordPress dashboard as an admin and head to Users > Settings > Security. From this tab, enable the option labeled as "Allow users to be disabled". ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/v1uO8kO6/5fa7bf94-8b9d-4982-8b07-77617db951a6.jpeg?v=4d0a3e95bbf30b5a4604a469b0490355) Upon enabling this option, you can disable the user from the users list by hovering over their username and clicking on "Disable". ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/P8uQPqXD/41f5d270-d368-435a-901e-61eab20b1a67.jpeg?v=d9ca8b357416661fe0640ed28b874b1f) Once a user is disabled, they will be prompted with the default message " Your account has been disabled. Please contact the site administrator". Like so: ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/YEuk0E4d/f3141c64-50f3-4136-8a6d-159a8802abaf.jpeg?v=bb938d20bbf894bb63b595bd856d430c) The administrator will have the capability to enable their account again from the same section where the "Disable" button will be changed to "Enable" and can be clicked to enable again. ![](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/llu0plOR/45753bca-1f4f-42ef-8946-29aebf7f2b01.jpeg?v=1c691f99f010749f65f35f3bc9eb3a4d) --- # Blocking deleted users from re-registering URL: https://wpusermanager.com/article/300-blocking-deleted-users-from-re-registering/ Last updated: 2022-01-28 If you are fighting spam signups on your site, you might be in the process of deleting users and then finding they re-register at a later date with the same email address. WordPress does not stop this, but with the Security addon for WP User Manager, you can block any email address from a user you have deleted from the site. Naviagte to Users > Settings > Security and turn on the 'Block Deleted Users' setting. This means any users deleted from the site by the site admin, will have their email address added to the block list so they can't re-register. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61f3b860d86136157d99e89a/file-3JBt0VymzY.png) --- # How to block sigups from specific email addresses URL: https://wpusermanager.com/article/299-how-to-block-sigups-from-specific-email-addresses/ Last updated: 2022-01-28 Spam is one of the most discouraging things about managing a WP User Manager membership site. It is possible to block users from registering on your site by either defining specific email addresses to block, or entire domains. For example, block all users with @hotmail.com email addresses. This functionality is included with the [Security addon](https://wpusermanager.com/addons/security/). ### Block Specific Email Addresses Navigate to Users > Settings > Security and scroll down to the 'Block List' setting. There you can enter the specific email addresses, using a new line for each email address.![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61f3b3798200bc052eb837a6/file-BfhP9BTZrW.png) ### Block Specific Email Domains If you want to block signups from any user using a specific email address domain, ie. all gmail addresses, you can add those domains on new lines to the Block List, eg. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61f3b61b68cd260cc2d3580f/file-wNIZAJwX5Z.png) --- # Passwordless WordPress Login URL: https://wpusermanager.com/article/288-passwordless-wordpress-login/ Last updated: 2021-08-12 [Passwordless Login](https://wpusermanager.com/addons/security/) is an easier way of logging into your WordPress site without the use of a password. Instead of asking users for a password when they try to log in to your site, they can simply enter their username or email and they will be sent an email to their registrered email address with a secure login link that automatically logs them into the site. It expires after one hour. How to Enable Passwordless Login -------------------------------- To enable the passwordless login for your site, go to your site dashboard - Navigate to Users > Settings - Click ‘Security’ - Turn on ‘Passwordless Login’ - Then click ‘Save Changes’ User Login ---------- Once enabled, when a user fills out the login form with their email address or username, they will see a message about the email sent to their address: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61152e536ffe270af2a9846a/file-Xrhx2Uzqyw.png) Here's a look at the email that gets sent to the registered email address. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61152f2db55c2b04bf6ddcc2/file-ovi3mEtHxT.png) Customizing the Email --------------------------------------------------------------------------------------------------------------------------------------------------------- You can customize the email by - Navigate to Users > Emails - Click ‘Customize' for the **Passwordless Login** email - Then in the sidebar click 'Passwordless Login' to edit --- # Two-Factor Authentication URL: https://wpusermanager.com/article/279-two-factor-authentication/ Last updated: 2021-04-25 All WordPress users can be subjected to automated password guessing schemes and brute force attacks, and having just a password to secure your website isn’t enough. You can use a Two Factor Authentication feature on your login page to add an extra layer of protection to your WordPress site. How to Enable Two-Factor Authentication (2FA) --------------------------------------------- To enable the two-factor authentication for your site, which will allow users to enable 2FA for their account, go to your site dashboard - Navigate to Users > Settings - Click ‘Security’ - Turn on ‘Enable Two-Factor Authentication’ - Then click ‘Save Changes’ ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/60840f7b3149d33a19c7027e/file-1h23SXKXDs.png) How Users Can Enable Two-Factor Authentication for Their Account ---------------------------------------------------------------- To enable the two-factor authentication feature on your site, login to your website using your username or email and your password. - Once you are logged in click on ‘Account Settings’ or navigate to your profile and click 'Edit Account' - Click on ‘Two-Factor Authentication’ - Turn on ‘Enable Time Based One-Time (TOTP) Password’ ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6085008df8c0ef2d98df5e47/file-GP6CcCj0AT.png) Once the TOTP is enabled, you need to scan the QR code or manually enter the authentication code from an authentication app to complete the setup. ### What Apps to Use There are a lot of authenticator apps available in Google Play and App stores. The most popular and easy to use authenticator apps are: 1. [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&gl=US) 2. [Microsoft Authenticator](https://www.microsoft.com/en-us/account/authenticator) 3. [Auty](https://authy.com/) 4. [LastPass Authenticator](https://lastpass.com/auth/) 5. [Duo Mobile Authenticator](https://play.google.com/store/apps/details?id=com.duosecurity.duomobile&hl=en&gl=US) ### How to Validate Using your authenticator app you can scan the QR code on your Account Setting page or manually enter the key. An Authentication Code will be generated by your authentication app. Enter the Authentication Code then click ‘Validate Code’. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/608500c5f8c0ef2d98df5e48/file-ooB4BlVRPK.png) ### How to Reset the Keys If you wish to reset your Authentication key just click on the ‘Reset Key’ button and you will have to re-scan the QR code and validate your Authentication Code to enable the Two-Factor Authentication. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/608501423149d33a19c70356/file-naQw9pZTsM.png) ### How to Backup Verification Codes You can also choose to backup your verification codes, just turn on the ‘Enable Backup Verification Codes (Single Use)’. To generate single use codes just click on ‘Generate Verification Codes’ and it will generate 10 unused codes which you can write down or download by clicking the ‘Download Codes’ button. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/60850188f8c0ef2d98df5e49/file-OKEFf3M32v.png) Once you have validated your authentication code click on the ‘Submit’ button and your Two-Factor Authentication feature is now active. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/608501ca3149d33a19c70357/file-IwCr2BIdyH.png) Live Preview ------------ After setting-up your Two-Factor Authentication feature, it’s time to test if it works properly. Log out from your Account, go to your login page and then log in again. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/60850206f8c0ef2d98df5e4a/file-eOLBeVRPxh.png) You will be asked for Authentication Code to proceed with your login. You can get your Authentication Code from your Authenticator App. Input your Authentication Code then click ‘Login’ to proceed. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/6085022a8af76a714bfdab35/file-F8HKPLZS1N.png) ### Disabling Two-Factor Authentication For a User Admins can disable 2FA for a user account by editing their user in the dashboard, and clicking the 'Reset Two-Factor Authentication' button ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/608502bd3149d33a19c70358/file-jTGn9O7oKt.png) --- # How to Strengthen WordPress Password Encryption URL: https://wpusermanager.com/article/264-how-to-strengthen-wordpress-password-encryption/ Last updated: 2021-01-23 WordPress encrypts user passwords with the insecure MD5-based password hashing. To improve this WP User Manager can use the modern and secure [bcrypt](https://en.wikipedia.org/wiki/Bcrypt). To do this, you need to have the [Security addon](https://wpusermanager.com/addons/security/) installed and your site running on PHP 5.5 or greater. - Navigate to User > Settings - Click the Security tab - Turn on the 'Use more secure password encryption' The encryption is backwards with passwords created before the setting was enabled and if it is disabled. --- # Password Strength Meter and Show Password Button URL: https://wpusermanager.com/article/263-password-strength-meter-and-show-password-button/ Last updated: 2023-04-27 There are a number of password related features that WordPress has for passwords on the backend of the site. However, it's in the benefit of site security for these to be used on the front of the site with WP User Manager login and registration forms. To do this, you need to have the [Security addon](https://wpusermanager.com/addons/security/) installed. Password Strength Meter ----------------------- First, you'll need to turn on the 'Disable Strong Pasword' option in User > Settings > Profile, then you can proceed in enabling this on any password field when setting a password (registration form, account password change, password reset forms) - Navigate to Users > Settings - Click 'Security' - Turn on 'Password Strength Meter' ![](https://wpusermanager.com/content/uploads/2021/01/wpum-security-password-strength.png) Show Password Button -------------------- This can be enabled on any password field when setting a password (registration form, account password change, password reset forms) - Navigate to Users > Settings - Click 'Security' - Turn on 'Show Password Button' ![](https://wpusermanager.com/content/uploads/2021/01/wpum-security-show-password.png) --- # Requiring password confirmation on Registration Forms URL: https://wpusermanager.com/article/260-requiring-password-confirmation-on-the-registration-form/ Last updated: 2021-01-23 When users are signing up for your site with the registration form, if you ask them to set a password by adding a password field to the form, it's a good idea to ask them to confirm the password so they don't enter the wrong password. To do this, you need to have the [Security addon](https://wpusermanager.com/addons/security/) installed, then edit the registration form in question (you can create multiple registration forms with the [Registration Form addon](https://wpusermanager.com/addons/registration-forms/)): - Navigate to Users > Registration Forms - Click 'Customize Form' for the form you want to add the password confirmation field to - Your form needs to already have a Password field added to it - Click 'Settings' - Turn on the 'Require Password Confirmation' setting When the registration form is viewed, a new password confirmation field is added below the password field. When the form is submitted it will fail to submit if the passwords are different. ![](https://wpusermanager.com/content/uploads/2021/01/wpum-register-password-confirm.png) --- # Security Installation URL: https://wpusermanager.com/article/259-security-installation/ Last updated: 2021-01-23 The following tutorial will guide you through the installation of the WPUM Security addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/private-content/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-security. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Security in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Prevent Concurrent Logins with the User Account URL: https://wpusermanager.com/article/262-prevent-concurrent-logins-with-the-user-account/ Last updated: 2021-01-23 If you want to stop users sharing the same username/email and password between multiple people, all logging into your site with the same credentials, then this can be done with WP User Manager. To do this, you need to have the [Security addon](https://wpusermanager.com/addons/security/) installed. - Navigate to User > Settings - Click the Security tab - Turn on the 'Prevent Concurrent Logins' Once enabled, if a user is logged into their account, then the same account is logged into from a different device from a different IP address, the existing logged in session is removed, preventing concurrent logins. --- # Deleting Inactive User Accounts URL: https://wpusermanager.com/article/261-deleting-inactive-user-accounts/ Last updated: 2021-01-23 If you have a site with lots of user signups, but you want to make sure those users are active, you can use WP User Manager to delete user accounts that have not logged in to the site for a period of time. To do this, you need to have the [Security addon](https://wpusermanager.com/addons/security/) installed. - Navigate to the Users > Settings page - Click on the Security tab - Turn on the 'Inactive Account Deletion Reminder' setting ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bf03cb9a8501b295d3634/file-lDddTol96s.png) Here you can set the number of days of inactivity before a user is deleted. The default is 30. If you want to send an email to the user before their account is deleted then with the 'Send Inactive Account Email' setting enabled, users will get an email sent 7 days before they are to be deleted. If they log in after getting the email, they won't be deleted. If the 'Inactive Account Interval' is less than 7 days, then the email reminder is sent out 1 day before deletion. You can edit the subject and body of the reminder email sent from Users > Emails > Delete Inactive Accounts ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/600bf132c64fe14d0e1fddf7/file-XGsIjMj2p5.png) --- # Set the user avatar image from LinkedIn URL: https://wpusermanager.com/article/272-set-the-user-avatar-image-from-linkedin/ Last updated: 2021-03-08 If you are using LinkedIn as a social login option, you might want to auto populate the users avatar image with their LinkedIn profile image. Here's the code you need to achieve this - https://gist.github.com/wp-user-manager/41cfe2d8f8926275f7d6a824665ed724 You would need to save this file to your /wp-content/mu-plugins/ directory (you might need to create the mu-plugins directory). Let me know if you need anything further. --- # Add Twitter login and registration to WordPress URL: https://wpusermanager.com/article/135-add-twitter-login-and-registration-to-wordpress/ Last updated: 2020-11-18 Adding social login methods to your site gives users a quick and easy way to sign up and login into your site. [WP User Manager](https://wpusermanager.com/) allows users to register and sign up from the frontend of the site, and this can be extended with the [Social Login addon](https://wpusermanager.com/addons/social-login/). WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. Twitter ------- To add Twitter login and registration to your WordPress website you need to have a Twitter account. If you have an account, login with your account and navigate to . ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d204286350aeeb52f5/5d6cf2cc0e834.png) Click the "**Create new app**" button to setup a custom twitter app. This app will be used for logins and registration through twitter. In the newly opened page, locate the "Callback URLs" setting and type **your website url followed by /wpum/auth/twitter.** ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ef9bfd12c7d3a10cba9b368/file-deCB0O7iFb.png) Once you've filled all the details about the app, click the "**Create your Twitter Application**" at the bottom of the page. Enable Twitter signin within your application --------------------------------------------- Once your new application has been created, navigate to the **"Settings"** tab and make sure the setting **"Allow this application to be used to Sign in with Twitter"** has been enabled. Additional required permissions ------------------------------- In order for WP User Manager to retrieve the email address of the user that tries to login with Twitter, you need to specifically enable the option within your Twitter application. To do so, you need to enter your website's privacy policy and terms of service. Enter the url of those pages within your app's settings and then save your changes. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d32c7d3a7a4d77f547/5d6cf2ccb1f86.png) Now that you've added your privacy policy and tos, you'll be able to enable the email setting. Navigate to the **"Permissions"** tab and enable the **"Request email addresses from users"** setting. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d304286350aeeb52f6/5d6cf2cd010d8.png) ### Setup your Twitter application within WP User Manager You Twitter application is now ready to be used within WP User Manager. Within your Twitter app, navigate to the "**Keys and Access Tokens**" tab and copy and paste the API Key and API Secret keys into your WordPress website. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d42c7d3a7a4d77f548/5d6cf2cd541b8.png) In your WordPress dashboard, navigate to "**Users -> Settings -> General -> Social Login**" and fill in the **Twitter API Key** and **Twitter API Secret** settings, with the keys that you've just retrieved. Your website is now ready to provide login and registration through Twitter :) [Get started adding social logins to your WordPress site.](https://wpusermanager.com/pricing/) --- # Add Google login and registration to WordPress URL: https://wpusermanager.com/article/165-add-google-login-and-registration-to-wordpress/ Last updated: 2020-11-18 Adding social login methods to your site gives users a quick and easy way to sign up and login into your site. [WP User Manager](https://wpusermanager.com/) allows users to register and sign up from the frontend of the site, and this can be extended with the [Social Login addon](https://wpusermanager.com/addons/social-login/). WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. 1) Create a Google Sign-in project ---------------------------------- Navigate to and click the **"Configure a project"** button. A new window will open which will guide you through the setup of a new project. From the dropdown then click "Create a new project" and type the name of the project. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e604286350aeeb5324/5d6cf2dfd9786.png) After clicking next, you'll be presented with the above screen. Simply type anything in there and then click next. 2) Configure your project ------------------------- In the next screen you'll be asked to configure your new project. Enter your full website url under the "Authorized Javascript Origin" field and click "create". ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e704286350aeeb5325/5d6cf2e03aa53.png) 3) Add credentials to WordPress ------------------------------- After clicking create you'll be given your credentials that you need to add into your WordPress website. **Do not click on "Done" yet.** ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e704286350aeeb5326/5d6cf2e095e00.png) After you've got your credentials. Login into your WordPress dashboard and navigate to " **Users -> Settings -> General -> Social Login**" and locate the settings "Google Client ID" and "Google Client Secret" and type in the credentials given to you by Google and save the settings. 4) Last steps ------------- From the previous popup, click on the "API Console" link at the bottom of the popup, in the new page, click the "Enable apis and services" button. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e704286350aeeb5327/5d6cf2e0e49de.png) Search for "identity" and then click on "Identity toolkit API" and then click on "Enable". ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e82c7d3a7a4d77f572/5d6cf2e141842.png) ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e82c7d3a7a4d77f573/5d6cf2e190233.png) After a few seconds, the API will be enabled and you'll be redirected to a dashboard for your app. From this screen there's one last thing you need to do. Click on "Credentials" in the right side of the screen then select "Oauth client" and you should see a page like this: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2e82c7d3a7a4d77f574/5d6cf2e1d8e40.png) Now under the **"Authorized redirect URIs"** enter your website url followed by /?wpumsl=google so if your website is - please type Your Google Sign in is now ready to be used :) [Get started adding social logins to your WordPress site.](https://wpusermanager.com/pricing/) --- # Add Instagram login and registration to WordPress URL: https://wpusermanager.com/article/198-add-instagram-login-and-registration-to-wordpress/ Last updated: 2020-11-18 ### IMPORTANT - Instagram no longer allow login via their API. We recommend using Facebook, Twitter or Google Login with the [Social Login Addon](https://wpusermanager.com/addons/social-login/). Adding social login methods to your site gives users a quick and easy way to sign up and login into your site. [WP User Manager](https://wpusermanager.com/) allows users to register and sign up from the frontend of the site, and this can be extended with the [Social Login addon](https://wpusermanager.com/addons/social-login/). WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. Register a new Instagram Client ------------------------------- Navigate to and login with your Instagram account and click on the "Register new client" button on this page . ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2fa2c7d3a7a4d77f59d/5d6cf2f42a6b9.png) Fill in all the details about the app and make sure that "Website URL" is your actual website url. For the "Valid redirect URIs" setting type your site url followed by /?wpumsl=instagram. If your website is , in that setting you would need to write . Credentials setup ----------------- Once your new client has been registered, you need to retrieve it's credentials and set them up into your WordPress website. Click on "Manage" onto your newly created client. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2fb2c7d3a7a4d77f59e/5d6cf2f47ee38.png) You'll be redirected to the settings of you app where you'll be able to **copy the client id and client secret keys** ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2fb04286350aeeb5358/5d6cf2f4c917d.png) Copy the client id and client secret keys and paste them into your WordPress website by logging into your dashboard and navigating to " **Users -> Settings -> General -> Social Login**" and locate the settings Instagram Client ID and Instagram Client Secret. Publishing your Instagram APP ----------------------------- After setting up your app you will need to get Instagram itself to review your App and approve it. Without approval from Instagram you will not be able to let your users login on your website with their Instagram account but only yourself, the owner of the app will be able to login through it. This is a restriction placed by Instagram. Once you're ready, click on "Permissions" and click on "Start submission" and complete the process. Instagram limited available info -------------------------------- Unfortunately, Instagram does not make email addresses available when requesting information through their API. This means that WPUM is unable to create an account via email because we don't know the address, all we have access to is the username. WPUM uses the username to create an account if it doesn't exist and a random email address is assigned. The user is then prompted to enter his real email address. The account is then marked as verified within your WordPress site so that only authorized login can access the account. [Get started adding social logins to your WordPress site.](https://wpusermanager.com/pricing/) --- # Add LinkedIn login and registration to WordPress URL: https://wpusermanager.com/article/144-add-linkedin-login-and-registration-to-wordpress/ Last updated: 2024-03-18 Adding social login methods to your site gives users a quick and easy way to sign up and login into your site. [WP User Manager](https://wpusermanager.com/) allows users to register and sign up from the frontend of the site, and this can be extended with the [Social Login addon](https://wpusermanager.com/addons/social-login/). WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. Create a LinkedIn App --------------------- Login with your LinkedIn account at the following page then click the "Create app" button. Fill all the required fields of the form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/65f82515909e484dba210671/file-75pcHMupsR.png) On the next screen you will need to click 'Request access' for the 'Sign In With LinkedIn using OpenID Connect'. This access is usually granted instantly![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/65f82573c7af9d69c480b2d1/file-tYkjglQ5kP.png) Once an app has been created, you'll be readirected to the settings of your app where you'll find Client ID and Client Secret keys under the 'Auth' tab. Under the **OAuth 2.0 settings** section, add your 'Authorized redirect URL' as your website URL followed by /?wpumsl=linkedin so if your website url is you'll need to type and then press the **"Add"** button. Ensure the correct scopes are listed: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/65f82624c68a4c3aac8886cb/file-oA71lFbaHX.png) Add credentials in WordPress ---------------------------- Make a copy of the Client ID and Client Secret keys. Now login into your WordPress dashboard and navigate to " **Users -> Settings -> General -> Social Login**" and locate the settings **LinkedIn Client ID** and **LinkedIn Client Secret** and type the keys from your LinkedIn APP. Now you're ready to accept logins through LinkedIn. [Get started adding social logins to your WordPress site.](https://wpusermanager.com/pricing/) --- # Add Facebook login and registration to WordPress URL: https://wpusermanager.com/article/134-add-facebook-login-and-registration-to-wordpress/ Last updated: 2020-11-18 Adding social login methods to your site gives users a quick and easy way to sign up and login into your site. [WP User Manager](https://wpusermanager.com/) allows users to register and sign up from the frontend of the site, and this can be extended with the [Social Login addon](https://wpusermanager.com/addons/social-login/). WP User Manager is one of the most straightforward to use WordPress membership plugins available, with a large number of [features](https://wpusermanager.com/features/) that turn your WordPress site into a membership platform. Facebook -------- To add Facebook login to your WordPress website you need to have a Facebook account. If you have an account, go to and login with your account. Once you're logged in, go to your apps and click on the **"Add new app"** button on the top right side of your screen to create a new Facebook app, enter the name of the app ( doesn't matter what you type ) and then click **"Create app ID".** Now that you've created the app, you'll be asked to add "products" to your app. Locate **"Facebook Login"** and click on "Set up". ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d12c7d3a7a4d77f540/5d6cf2ca568f3.png) You'll now be asked to select a platform. Select the option **"web".** You'll then be required to add the url of your website. Add your url into the **"Tell us what the URL of your site is."** field. Then press next on all the other sections and skip them. After you're finished, click on "Settings" under the Facebook login app on your sidebar: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d12c7d3a7a4d77f541/5d6cf2cab766b.png) Make sure the following settings are enabled: - Client OAuth Login - Web OAuth Login Locate the **"Valid OAuth redirect URIs"** setting and add your site url followed by **?wpumsl=facebook** ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d12c7d3a7a4d77f542/5d6cf2cb140e0.png) There's just one more setting left. Click on "Settings -> Basic" and take note of the "App ID" number and "App Secret" key. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2d22c7d3a7a4d77f543/5d6cf2cb6dfea.png) You now need to add those details into your **WordPress site**. Login into your **WordPress dashboard** and navigate to **"Users -> Settings -> General -> Social Login".** Locate the settings called **Facebook Client ID (APP ID)** and **Facebook Secret** and copy the APP ID and App Secrete from facebook into their respective fields in WordPress. Make sure you publish your app when you're finished. Now you're done! :) [Get started adding social logins to your WordPress site.](https://wpusermanager.com/pricing/) --- # Social login add-on installation URL: https://wpusermanager.com/article/115-social-login-add-on-installation/ Last updated: 2019-09-02 The following tutorial will guide you through the installation of the Social login add-on for WP User Manager. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/social-login/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-social-login. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder. ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - Social Login in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Enable networks and choose display location URL: https://wpusermanager.com/article/104-enable-networks-and-choose-display-location/ Last updated: 2019-09-02 Once activated, new settings into the WPUM Settings panel will be available. From your WordPress dashboard, navigate to Users -> Settings -> General and locate the **"Social Login"** setting. From this setting you can choose which social networks you wish to enable. ### Display location: Once you've enabled one or more social networks, you can now select where the buttons should appear on your website. Locate the **"Social buttons location"** setting from the same page mentioned above and select one or more locations for the buttons. --- # Social login buttons shortcode URL: https://wpusermanager.com/article/103-social-login-buttons-shortcode/ Last updated: 2019-09-02 The social login add-on provides and helpful shortcode if you wish to display the buttons anywhere within your site. The shortcodes is available within the WP User Manager shortcodes generator. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cefa42c7d3a7a4d77f4e5/5d6cef9db4964.png) Alternatively you can manually add the shortcode if you can't access the shortcode generator. The shortcode supports a "redirect" parameter that can be used to specify the url where users will be redirected after login or registration through a social network. ``` [wpum_social_login_buttons redirect="http://example.com"][/wpum_social_login_buttons] ``` --- # Stripe Pro Installation URL: https://wpusermanager.com/article/336-stripe-pro-installation/ Last updated: 2023-03-12 The following tutorial will guide you through the installation of the WPUM Stripe Pro addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/stripe-pro/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-stripe-pro. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM Likes in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Adding columns to the Manage Signups table URL: https://wpusermanager.com/article/257-adding-columns-to-the-manage-signups-table/ Last updated: 2021-01-12 The Manage Signups table accessed from Users > Manage Signups, is where site admins can manually approve or reject user registrations when using the [User Verification](https://wpusermanager.com/addons/user-verification/) addon for [WP User Manager](https://wpusermanager.com/). ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5ffd7b8066df373cab708690/file-bx01XI8eFX.png) But sometimes to make it easier to decide if to approve or reject you might need to see more data about the user, including [custom fields](https://wpusermanager.com/addons/custom-fields/) that they have filled out at user registration. To add custom columns you will need to add this script to a wpum.php file in your /wp-content/mu-plugins/ directory (you might need to create the mu-plugins directory). You can edit the columns and field keys as needed, or add more: https://gist.github.com/wp-user-manager/6c42ca9badc9a68b4e915f2198729d77 --- # Managing signups URL: https://wpusermanager.com/article/130-managing-signups/ Last updated: 2019-09-02 The user verification addon comes with 2 registration moderation modes. Manual approval and email verification. To select which mode you'd like to use, navigate to Users - settings -> registration -> User verification -> verification method. Email verification mode: ------------------------ Once enabled, users have to click a link within their registration email to verify their account. When the link is clicked, users will be redirected to your website and a notice will display whether or not their account has been automatically approved. An error message will only appear if the verification key for the user is wrong or the user has already been verified. Note: the link within the registration email will not be automatically added. You will have to manually add a new email tag to your registration email text. #### How to add the verification link to your registration email: Navigate to Users -> emails and edit the "registration email". A new email tag is now available and it's called ``` {verification_link} ``` Add the tag to your email and save the settings. You're done :) If users do not verify their account within 30 days, their account is automatically deleted from the site if you enable the option. Manual verification mode: ------------------------- The manual verification mode allows site administrators to manually moderate registrations to the site. You can choose which users you will approve or reject. Note: rejecting a user signup, will delete his account. Navigate to Users -> Manage signups to see pending registrations. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ce04286350aeeb52f0/5d6cf2c81ac64.png) Hovering with your mouse onto a user will display 3 different actions. You can decide to approve, reject or send a new verification email to the user. An email will be sent to the user in all 3 cases. You can customize these 3 new emails in **Users -> Emails**. There you will see 3 new emails available from the emails editor. --- # User verification addon installation URL: https://wpusermanager.com/article/113-user-verification-addon-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM User Verification addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/user-verification) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-user-verification. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - User Verification in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Login restriction URL: https://wpusermanager.com/article/197-login-restriction/ Last updated: 2019-09-02 When the user verification addon is enabled. Users will not be able to login until they've verified the account or an administrator has manually approved it. If the user tries to login an error message will appear. --- # Automatic account removal URL: https://wpusermanager.com/article/132-automatic-account-removal/ Last updated: 2019-09-02 If you're using the email verification mode, you also have the option to automatically delete users that haven't verified their account within 30 days. To enable the automatic removal system, navigate to Users -> settings -> registration -> user verification and enable the option "Automatically remove users". --- # How to collect payment for a user at registration URL: https://wpusermanager.com/article/298-how-to-collect-payment-for-a-user-at-registration/ Last updated: 2022-01-03 When building a membership or community site you may want to ask your users for payment for joining the site. This is possible when combining [WP User Manager,](https://wpusermanager.com/) [WooCommerce](https://woocommerce.com/) and the [WooCommerce addon](https://wpusermanager.com/addons/woocommerce/). ### Prerequisites First you need to have the following plugins installed: 1. WP User Manager 2. WooCommerce 3. WooCommerce addon for WP User Manager You then need to have one or more payment gateways configured in WooCommerce. Next, you need to have created one or more Virtual WooCommerce products that will be used for purchasing at registration. ### Registration Form Settings To turn an existing registration form into a form that collects payment, navigate to Users > Registration Forms and select the form. Click the 'Settings' tab. You can then choose if you want your users to select from many products or just register with one. If the registration form should only have one product to purchase, select that product in the 'Registration Product' dropdown:![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1c95bcbdcf558843100f4/file-FGrLWUSwqG.png) If you want them to choose their product, enable the 'Allow Product Selection' setting and then select the products they are allowed to choose from: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1c9226e49f25358bca270/file-sA0zW2bGyR.png) ### Registration With a specific product selected for the form, when a user comes to register it shows that product name and price underneath the registration form fields: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1ca72d1a2f12bbe2200e2/file-OOutAwd2Wi.png) The next step of the registration form is where the user enters their payment information to complete the payment: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1cdfecbdcf55884310103/file-G0MKeMQFYq.png) Once the payment information has been entered and the user has clicked 'Complete Registration', their registration is complete and they are shown the details of what they have purchased: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1ce876e49f25358bca278/file-SzGd6hZpG2.png) ### Completing Payment Later If a user attempts to register but doesn't complete the checkout step of the registration form, they will have access to complete the payment later through the 'subscribe' tab on their account page (https://yoursite.com/account/subscribe): ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1d08d2c86b66933f57771/file-TKkeqN1rGT.png) The Subscribe tab name and slug can be customized with the 'wpum\_woo\_subscribe\_account\_tab\_name' and 'wpum\_woo\_subscribe\_account\_tab\_slug' filters respectively. ### Restricting Access For some sites you will want to enforce all users to complete payment before they can access any of the site. In the case you would need to enable the 'Restrict Access Until Paid' registration form setting: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1d1012c86b66933f57772/file-abYtGafNNP.png) This means when a user who hasn't completed the payment logs in to the site, they will be always redirect to the account page to complete payment. It will show a notice informing them what to do: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/61d1d18acbdcf55884310108/file-CF6onUWRX6.png) The notice message is configurable with the 'wpum_woo_unsubscribed_message' filter. ### Content Restriction Integration If you are using the [Content Restriction addon](https://wpusermanager.com/addons/content-restriction/) you can restrict specific posts, pages and custom post types to users that have completed payment using the 'Restrict by Subscription' checkbox in the 'WP User Manager - Content Restriction' meta box. ### Subscriptions Integration If you are using the [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) plugin, you can get users to purchase a subscription product at registration, which allows you to collect recurring payments for membership to your site. --- # Add Woocommerce Billing Address Fields to a Registration Form URL: https://wpusermanager.com/article/284-woocommerce-billing-address-fields/ Last updated: 2021-04-30 As part of the [WooCommerce addon](https://wpusermanager.com/addons/woocommerce/) improvements you can now capture users’ billing address and phone number by adding WooCommerce billing fields to your registration form. 1. Navigate to Users > Registration Forms ![](https://lh3.googleusercontent.com/5glosws7jxsIuPR_2kmi7C2fSZ6bDlqnONjBGyWxjyiPD1Ba4QzEoDJErGHshENnFzHRR12B799tV97I3o8oV1kOT4e4W7EPtG-A9qvbhgpf7GKSPBQRfGdbZR4TDHHn7Vn52fP9) 1. You can ‘Add New Form’ or customize your existing form by clicking on ‘Customize Form’. ![](https://lh5.googleusercontent.com/Z3tdVKknBrtbKEOxM9oU82HLycnpLbddXWPfGYCyKBH6izoYCh_OuCEgiSVMTjQ2PM0a_AI0tTasyPNYBD536SVES_-b9VS5fLwyplFw0D7tywGHRs2TQTBtgQfb6j0nVupNEHEp) 1. With WooCommerce Addon installed on your WordPress, the ‘WooCommerce billing fields’ will be included in the list of available fields that you can use for your registration form. You can now Drag and Drop the ‘WooCommerce billing fields’ from the list of ‘Available Fields’ to the ‘Form Fields’. ![](https://lh4.googleusercontent.com/71ki_UK7Pyui-JB8OcIaPzCfmvT4lnvfnr35ROKyODlbYnLFofNd40KfOKFJrNvE8LolRKVdWmHsCiypkZ0RYZT8tzn-uNbnxdYpMgiCVl5OItH15JeR_aoUdlEEJiWcI3C7ksYe) 1. The changes you made in your Registration Form will be saved automatically. 2. To preview your Registration Form log out of your account then navigate to ‘Register’. 3. Users can now see the Billing Address fields in your Registration Form. ![](https://lh3.googleusercontent.com/R21or8Tv5CGBDRRSMWP72UjFA6nbuxCfBVX3PuI7iuj5a5wvKYnP_oXhd-2PZUeyDbNWz696rFVqMjYql3dKc9u5mljbO4iL3bwSPEliYO0Wn0eeLPQ91nX_9HxUQU2dFZllD7O6) --- # Show Subscriptions in the Account Page URL: https://wpusermanager.com/article/283-show-subscriptions-in-the-account-page/ Last updated: 2021-04-30 With the new [WooCommerce addon](https://wpusermanager.com/addons/woocommerce/) improvements you can now display you users’ subscriptions by integrating with the WooCommerce Subscriptions plugin. But first you need to have a WooCommerce Subscription extension. 1. In your Dashboard navigate to WooCommerce > Extensions. ![](https://lh6.googleusercontent.com/9B9TrjPhO-8ATb48ZwPWcdkUp8aR6JNd_VtE02ID6Fvaf7IFg5Ybog4bokWaM8CCy-OQ0EkHi5dIMaCr7cEI9CZckf2JZ_kBG6aEeqsg_CsirdfJE9VwDJDwKEGX4O6qLe7k20cj) 1. You can now see all the extensions offered by WooCommerce including the ‘Subscriptions’. ![](https://lh4.googleusercontent.com/6vQpyX_ZyCwrTiBVMLc6l2UmzhJlkgK6QXtkI-0LqUU7inetfTprchRCfvsyBh269xJrROJ9Tr7RNC0kHdava-LvJ9Dv5z-1jhKN0m6W3K492yaRczAsEn1flBTZVuQ6gYPSjndm) 1. After purchasing this extension, your WordPress site will now integrate with WooCommerce Subscriptions to allow users to view their subscriptions from their account page. 2. Once a customer purchased a subscription product from your store, the customer can view the details of his subscriptions on the ‘My Account’ page. ![](https://lh6.googleusercontent.com/ZYmAatgNSJ2S54j7DagVLnH5m-jwy649TVjyr5pBtIcsm_4AI7wAQ27nMXdyjJAttMjTUrsYn99yKgjGQFj2uCQL2BhIIEfpPXntKFVf9KfJ9jPcgWCHaH4sHClCRLbgaeYumzBH) --- # Display Downloads in the Account Page URL: https://wpusermanager.com/article/282-display-downloads-in-the-account-page/ Last updated: 2021-04-30 To display the WooCommerce ‘Downloads’ on a user’s account page, 1. Navigate to Users > Settings ![](https://lh5.googleusercontent.com/cI4uSm1BSaQYXWmpGZ593VN7ODjG8e0BkOz9opJ0o_SFkuZo_ToUTvu_ywfnC3v-gOf6zA3HAAln8GfpVGo-s-KHWr34gPfLX3ZmCoGZRSlr93Lurgg9JMqdgKhIku8AY00t9z-a) 1. Go to Profiles > Account. You can then turn on the ‘Show Downloads’ setting, then click ‘Save Changes’. ![](https://lh5.googleusercontent.com/yd4N2LrAd_124dZEjgU55Y9x4-0ftxJ970bxIklM5rfqc8esDxoNGGglvgSwnWNVvbtQVWnFq6smR7F9gomkL6BaGeBE6Kih6TLlV8bHT14dn2EOAsneklX1_04x6vTAhcdq3W-Q) 1. The users can now view their downloads and the details for each item, directly from their account page. Just login to their account navigate to Account > Downloads. ![](https://lh3.googleusercontent.com/bv88WFpq81IR2Z4Amjw5YJW65g9iMVSfQROojTupUY_QXlOdIjJ7SdozCzcEcwzcKV9BAFw3SujLqhpPeMDpDcILZGvYUcZavvFB7wXfyEjDL6cM_JkZqU8RJNHV8vwy1GtNp4Ar) --- # WooCommerce addon installation URL: https://wpusermanager.com/article/206-woocommerce-addon-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM - WooCommerce addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/woocommerce/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-woocommerce. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM - WooCommerce in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # View and edit billing address URL: https://wpusermanager.com/article/210-view-and-edit-billing-address/ Last updated: 2019-10-26 To display the WooCommerce billing address on a user's account page, navigate to Users > Settings > Profiles > Account. You can then turn on the 'Show Billing address' setting. Users can then view their address and make changes, direct from their account page. --- # Display orders on the account page URL: https://wpusermanager.com/article/209-display-orders-on-the-account-page/ Last updated: 2019-10-26 To display the WooCommerce orders on a user's account page, navigate to Users > Settings > Profiles > Account. You can then turn on the 'Show Orders' setting. Users can then view all their orders and view the details for each one, direct from their account page. --- # Display product reviews on the user profile URL: https://wpusermanager.com/article/207-display-product-reviews-on-the-user-profile/ Last updated: 2019-10-26 To display the reviews that a user has left on products on their profile page, navigate to Users > Settings > Profiles > Profiles content. You can then turn on the 'Display Reviews' setting. By default only logged in users will see this on the profile, but you can allow guests to view them by turning on the 'Allow Guest to View Reviews' setting. --- # Display product purchases on the profile URL: https://wpusermanager.com/article/208-display-product-purchases-on-the-profile/ Last updated: 2019-10-26 To display the products that user has purchased on their profile page, navigate to Users > Settings > Profiles > Profiles content. You can then turn on the 'Display Purchases' setting. By default only logged in users will see this on the profile, but you can allow guests to view them by turning on the 'Allow Guest to View Purchases' setting. --- # View and edit shipping address URL: https://wpusermanager.com/article/211-view-and-edit-shipping-address/ Last updated: 2019-10-26 To display the WooCommerce shipping address on a user's account page, navigate to Users > Settings > Profiles > Account. You can then turn on the 'Show Shipping address' setting. Users can then view their address and make changes, direct from their account page. --- # Translating strings from WP User Manager Addons URL: https://wpusermanager.com/article/295-translating-strings-from-wp-user-manager-addons/ Last updated: 2021-09-02 There are some WP User Manager addons that have strings used in the frontend of the site that will also need to be translated with WPML. For example, the WPUM Delete Account addon adds a new account settings page called 'Delete Account': ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/613092df12c07c18afdd04bb/file-iS6qTRby2T.png) To translate the strings in the Delete Account addon, you will need to WPML String Translation addon: Then go to WPML > Theme and plugin localization, scroll down to 'Plugins' and select the 'WPUM Delete Account' plugin and then click **Scan selected plugins for strings**. Once WPML has scanned the strings, they will be available to translate in WPML > String Translation under the 'wpum-delete-account' domain. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/613093742b380503dfded673/file-8DB4r05zsM.png) --- # Translating WP User Manager data with WPML URL: https://wpusermanager.com/article/254-translating-wp-user-manager-data-with-wpml/ Last updated: 2021-05-12 The WP User Manager plugin codebase is generally well translated and can be [translated using a plugin like Loco Translate](https://wpusermanager.com/article/181-how-to-use-loco-translate-for-wp-user-manager), what about the data that you create with WP User Manager, like custom fields? For a true mulitilingual site, you will want users to register in their chosen language - but the fields on the registration form need to be translated to the various languages your sites supports. [WPML](https://wpml.org/) is one of the best translation plugins for WordPress sites, allowing you to translate posts, pages and other post types. With the [WPML addon](https://wpusermanager.com/addons/wpml/) for WP User Manager you can translate the following data: 1. Field Groups 1. Name 2. Description 2. Custom Fields 1. Label 2. Description 3. Placeholder 4. Option labels (for dropdown, checkbox and radio button groups) 3. Registration Forms 1. Names The addon also allows you to translate the subject and message of any email sent by WP User Manager. That includes but not limited to: - Registration confirmed - User approved - User Rejected - Email verification - Group approved - Group rejected *Some of the above emails require other addo*ns. Prerequisites ------------- Before starting, you must have the WPML Multilingual CMS, WPML String Translation, and WPML Translation Management plugins installed and activated: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/609bbf71a6f4b5439f4afd8b/file-Qvs2shmKSQ.png) Translating ----------- Once you have installed and activated the WPML addon, if you navigate to WPML > String Translations you will see strings that need translating from your existing WP User Manager data: ![](https://wpusermanager.com/content/uploads/2020/11/wpum-wpml-string-translation.png) Here you can add language translations for all the different types of WP User Manager data listed above. Any new data you add, like adding a new custom field, will appear in this table ready to translate. --- # WPML Installation URL: https://wpusermanager.com/article/255-wpml-installation/ Last updated: 2023-02-17 The following tutorial will guide you through the installation of the WPUM WPML addon. Installation from your WordPress dashboard ------------------------------------------ Once the [addon has been purchased and downloaded](https://wpusermanager.com/addons/groups/) you should have a zipped package ready for installation. Installing the addon is just like any other WordPress plugin. Navigate to your WordPress “Plugins -> add new” page, inside of your WordPress dashboard, and follow these instructions: 1. Click the "upload plugin" button. 2. Select the downloaded zipped package file. 3. Press the "install now" button. 4. Activate the addon. The addon is now activated and ready to be configured. Installing manually via FTP --------------------------- Once you have the zip file, open it (typically by double clicking it) and inside you'll file a folder called wpum-wpml. Use your favorite file transfer tool (e.g Filezilla) to copy that FOLDER (not just its contents) to your server, and place it in folder ``` wp-content/plugins/ ``` Then go to the plugins page in your WordPress site and you should see WPUM WPML in the plugin list. Click the Activate link and you'll be ready to use the addon. --- # Translating the Login Form with WPML URL: https://wpusermanager.com/article/270-translating-the-login-form-with-wpml/ Last updated: 2021-02-19 Unlike the Registration form, the login form fields aren't stored as fields in the database, so translating them is a little different in WPML. The strings that need to be translated are in the code of the WP User Manager plugin. To translate these strings you ned to have both the WPML Multilingual CMS and WPML String Translation installed. Navigate to WPML > Theme and plugins localization in the WordPress admin sidebar. Scroll down to the 'WP User Manager' item in the 'Strings in the plugins' table. Click 'create PO file' for the 'wp-user-manager' entry. After some time it will generate the strings, and you can click the number of strings to start translating the plugin's strings. Use the 'search for' box to search for the following strings to translate: - Username or email - Email - Username - Password - Remember me --- # How to change the required score for reCaptcha v3 URL: https://wpusermanager.com/article/344-how-to-change-the-required-score-for-recaptcha-v3/ Last updated: 2023-07-20 reCAPTCHA v3 is based on a user score. If users are being rejected based on the captcha (and assuming the API keys being used are for v3), they are being scored too low. The plugin currently uses Google’s default of 0.5 as a necessary score to clear the captcha. (See: ) If you would like to lower the score, you may proceed in using this snippet utilizing the filter `wpum_recaptcha_score_threshold` https://gist.github.com/MarkKevin08/59b01f9d963c33091f2ce114e876490a --- # Changing the display format for the Date field picker URL: https://wpusermanager.com/article/343-changing-the-display-format-for-the-date-field-picker/ Last updated: 2023-03-15 Here's how you change the date format in the Date field picker: https://gist.github.com/wp-user-manager/a816b7290ab44f0825502691ce1d34c4 --- # How to add profile tabs to external URLs URL: https://wpusermanager.com/article/314-how-to-add-profile-tabs-to-external-urls/ Last updated: 2026-10-15 To add a tab to the profile page that links to another site, register the tab and then change its URL with two filters. This example adds a "Google" tab that sends users to Google: ``` esc_html( 'Google' ), // the name shown on the tab 'priority' => 2, ]; return $tabs; } add_filter( 'wpum_get_registered_profile_tabs', 'my_wpum_add_profile_tab_link' ); function my_wpum_get_profile_tab_url( $url, $tab ) { if ( 'google' === $tab ) { return 'https://www.google.com'; // where the tab links to } return $url; } add_filter( 'wpum_get_profile_tab_url', 'my_wpum_get_profile_tab_url', 10, 2 ); ``` Change the tab key (**'google'**, used in both functions), the tab name and the URL to suit your site. **'priority'** sets the tab's position among the profile tabs. The snippet is also available as a [gist](https://gist.github.com/wp-user-manager/255daeb154155916fa0b6d0b73a8fc9d). Save it to a file in your `/wp-content/mu-plugins/` directory (create the mu-plugins directory if it doesn't exist). --- # How to alter the links in the already logged in template URL: https://wpusermanager.com/article/312-how-to-alter-the-links-in-the-already-logged-in-template/ Last updated: 2026-10-15 WPUM uses a template called **already-logged-in.php**. It is what a logged-in user sees when they visit the login page: ![The already logged in message on the login page, with links to the profile, account and logout](https://p-d0FK22zG.t2.n0.cdn.getcloudapp.com/items/12uzAkPD/201b1835-3bae-477a-af5b-bc0a522089b2.jpeg?v=fe892b69c66be0bf4a96614418c666d4) To remove or change the links it shows, use the **wpum\_already\_logged\_in\_links** filter. The links are keyed `profile`, `account` and `logout`. This example removes the account link: ``` roles, true ) ) { return home_url( '/author-page' ); } if ( in_array( 'subscriber', (array) $user->roles, true ) ) { return home_url( '/subscriber-page' ); } // Add more conditions for each role as needed. return $redirect; }, 10, 2 ); ``` Change the role names (**'author'**, **'subscriber'**) to the roles on your site, and the paths (**'/author-page'**, **'/subscriber-page'**) to the pages each role should go to. Users whose role isn't listed go to the page set in Users > Settings > Redirects > After Login. The snippet is also available as a [gist](https://gist.github.com/wp-user-manager/e00b8253c7719b7ef6ecd266495eb57e). This filter only runs when someone logs in. After registration, users go to the page set in Users > Settings > Redirects > After Registration, which is the same for every role. See [Redirects Settings](https://wpusermanager.com/article/140-redirects-settings/). --- # How to rename Account page tabs URL: https://wpusermanager.com/article/225-how-to-rename-account-page-tabs/ Last updated: 2020-06-14 If you want to rename the tabs on a users account page, you will need to create a new file wpum.php in wp-content/mu-plugins/ (create the directory if it doesn't exist) You can then change the name for the tab you want to alter. https://gist.github.com/wp-user-manager/aee521221a18211efd38cc2cd10afbe7 --- # How to rename Profile page tabs URL: https://wpusermanager.com/article/224-how-to-rename-profile-page-tabs/ Last updated: 2020-02-19 If you want to rename the tabs on a users profile page, you will need to create a new file wpum.php in wp-content/mu-plugins/ (create the directory if it doesn't exist) https://gist.github.com/wp-user-manager/b4da9e2300affedf4359944bca0246b7 You can then change the name for the tab you want to alter. --- # How to create custom email tags URL: https://wpusermanager.com/article/138-how-to-create-custom-email-tags/ Last updated: 2019-09-02 1. Register your custom tag --------------------------- To register a new email tag you will need to use the `wpum_email_tags` filter. This code can be added to your theme's functions.php ``` function wpum_my_email_tag( $tags, $emails ) { $tags[] = array( 'name' => 'Tag name', 'description' => 'description goes here', 'tag' => 'your_tag', 'function' => 'my_email_tag_function' ); return $tags; } add_filter( 'wpum_email_tags', 'wpum_my_email_tag', 10, 2 ); ``` In the above example we've registered a new tag called "Tag name", the tag that will then be used within the email is "your\_tag". The function parameter sets the name of the function that will be used to manipulate the output of the tag within the emails. The next step is to create a function with the name specified above. 2. Define the output of the custom tag -------------------------------------- The function that handles the output of the tag, takes 1 parameter -> $user_id which can be used to retrieve [content related to the user](https://codex.wordpress.org/Function_Reference/get_user_meta). In the following example we're going to retrieve the content of a custom [meta field](https://codex.wordpress.org/Function_Reference/get_user_meta) called "wpum_field_11". ``` function my_email_tag_function( $user_id ) { return get_user_meta( $user_id, 'wpum_field_11', true ); } ``` 3. Add the tag to the emails content ------------------------------------ Now that you're registered the tag and created the output of the tag, you'll find the new tag within the emails editor. Edit your emails and add {your\_tag} to your emails. The tag will now display the content that you defined with your custom function. --- # How to customize the fields output on profile page URL: https://wpusermanager.com/article/107-how-to-customize-the-fields-output-on-profile-page/ Last updated: 2023-06-03 The `wpum_field_ouput_callback_function` filter passes 3 arguments, the original callback function used for the field, the field object and the value. See here for the source code Example field output customization: ----------------------------------- The filter can be used to use a custom function to modify the output of the field within profiles pages. By default WPUM uses separate functions for each field output. By using the filter, you can tell WPUM to use another function to print the field output on the profile page. In the following example, I'm modifying the output of the Website field, by checking it's name. [Other methods can be used to determine the field](https://github.com/WPUserManager/wp-user-manager/blob/master/includes/fields/class-wpum-field.php). Example: ``` function wpum_custom_field_output( $func_name, $field, $value ) { if ( $field->get_name() == 'Website' ) { return 'my_custom_function'; } return $func_name; } add_filter( 'wpum_field_ouput_callback_function', 'wpum_custom_field_output', 10, 3 ); function my_custom_function( $field, $value ) { return ''. esc_html( $value ) .''; } ``` --- # Introduction for developers to WP User Manager URL: https://wpusermanager.com/article/106-introduction-for-developers-to-wp-user-manager/ Last updated: 2023-02-17 WP User Manager has been coded with developers in mind, the code is well laid out, easy to read, and documented. The source code for WPUM is also highly extensible, which makes it easy for developers to hook in custom functionalities, or modify existing parts of the plugin. ### Github - For Tracking The entire source code of WP User Manager is [available on Github](https://github.com/WPUserManager/wp-user-manager). This is also the place where bugs and enhancements are tracked. Furthermore milestones are created as an easy way to track features and fixes that are released with each new update. ### Code Organization The source of code of WP User Manager is organized in separate, meaningfully named files and folders. For example, all functions, filters and actions related to "User Directories" can be found into the sub folder "includes/directories". In this folder you will find additional files named after it's purpose. For example: the functions.php file into the "directories" subfolder contains all the functions for working with user directories. ### Functions and Classes naming All functions, with no exception, are prefixed with "wpum\_". This helps ensure that the plugin does not cause any conflict with other plugins or functions with similar/same names. For example, do not create functions named like this: ``` function my_function() { // Your code here } ``` Instead, you should do this: ``` function wpum_my_function() { // Your code here } ``` PHP Classes should also follow the same naming rules. ### Submitting your addons If you have written a custom addon and you wish to be listed onto the wpusermanager.com website, please [get in touch](https://wpusermanager.com/contact) so I can review it for you. --- # Populating a fields options with a large set of options URL: https://wpusermanager.com/article/310-populating-a-fields-options-with-a-large-set-of-options/ Last updated: 2022-09-12 If you are using a custom field like a dropdown, multiselect, checkbox group or radio button group, populating the options for the field can be time consuming if your field has a lot of options. Previously you would have to type in each option's value and label manually or use a filter to populate the options from a stored dataset (for example, using a [PHP array of US states for a field](https://wpusermanager.com/article/199-how-to-add-a-us-state-dropdown-field/)). As of WP User Manager 2.8.9 you can take a CSV list of options and paste them into the field options to quickly populate your field options. For example, you have a list of countries like this - one option per line, value and label comma separated: ``` england,England france,France germany,Germany ``` When creating a custom field with options, click 'Add option' to add an option with value and label inputs. Copy the list and paste into the first value input. All the options will be automagically populated into options: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/631efb5d7164226be0c850bb/file-D2WhCpjvwU.gif) --- # How to conditionally set a user role at registration using a custom field URL: https://wpusermanager.com/article/292-how-to-conditionally-set-a-user-role-at-registration-using-a-custom-field/ Last updated: 2022-11-16 If you are using one registration form but want to register multiple types of users that will be given different roles on your site, then you might want to use a custom field which controls what role to give them. For example, you add a dropdown to your registration form and depending on what value they select, they get assigned a different role. To get started, make sure the registration form is set to assign a default role for new users: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/612f4cdb6c65aa15b87d626f/file-Koq3JrVtle.png) Then add a custom field you have created in Users > Custom Fields to the registration form, in my example I have a dropdown to capture the County they live in: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/612f4d1600c03d6720752e56/file-OjqRyj4dia.png) Find out they meta key of the field: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/612f4d376c65aa15b87d6272/file-L4zYqdZqGM.png) Then grab the code below and save to a wpum.php file to your /wp-content/mu-plugins/ directory (you might need to create the mu-plugins directory). https://gist.github.com/wp-user-manager/6d845fd9bf0d6f0e2c665b1f9d38bd74 You will need to edit the meta field key to use your field, and also change the value logic so that the role is set to a different role if the field value is set as that value. You can then change the role as needed. You can alter this logic to cater for fields that have multiple different options and different roles. --- # How to add a new tab to the Edit Account page URL: https://wpusermanager.com/article/234-how-to-add-a-new-tab-to-the-edit-account-page/ Last updated: 2020-09-16 If you want to show some extra information or data to the user when they are editing their account, you can add a new account side navigation tab with the following code: https://gist.github.com/wp-user-manager/60d0703a817d974ae3880d03cb0c2df3 To then render your data on the tab content, you need to add function hooked to the `wpum_account_page_content-{tab-slug}` action: https://gist.github.com/wp-user-manager/f60046398c59b6114d681cfcf00ef8aa --- # Displaying more than 10 comments on the profile URL: https://wpusermanager.com/article/214-displaying-more-than-10-comments-on-the-profile/ Last updated: 2019-11-03 By default, a maximum of 10 comments are displayed on a User's profile. To change this add the following code to an mu-plugin or your theme's functions.php file https://gist.github.com/wp-user-manager/c038ccf873913b23c8829e03175db114 --- # How to add an external link to the Account page tabs URL: https://wpusermanager.com/article/213-external-link-account-tabs/ Last updated: 2019-10-29 If you want to add a new tab to the Accounts page that adds an external link, add the following code to a file in wp-content/mu-plugins (eg. wpum.php) or your theme's functions.php file: https://gist.github.com/wp-user-manager/e06dba03ff81239b40ff5c6df3d98616 --- # Redirecting the author URL to the user profile URL: https://wpusermanager.com/article/203-redirecting-the-author-url-to-the-user-profile/ Last updated: 2023-01-27 If you want to make sure that author URLs redirect to the user's profile page, eg. > Then add this code to a file in wp-content/mu-plugins/ or to your theme's functions.php https://gist.github.com/wp-user-manager/4a31e4f085b8f8a6fed3a1c79a0fd69d --- # Allow administrators to view profiles, when members cannot URL: https://wpusermanager.com/article/202-allow-administrators-to-view-profiles-when-members-cannot/ Last updated: 2019-10-16 If you have disabled the 'Allow members to view profiles' setting but you still want site administrators to be able to view profiles, then add this code to an mu-plugin or your theme's functions.php: https://gist.github.com/wp-user-manager/04738893f2c5c6a75044696c63c8bf75 --- # Automatically resize uploads for avatars URL: https://wpusermanager.com/article/201-automatically-resize-uploads-for-avatars/ Last updated: 2019-10-15 If you want to ensure all avatar mages uploaded are resized to a specific file size (width and height), then add this code to an mu-plugin file or your functions.php file: https://gist.github.com/polevaultweb/caefbec5eaaa9e5f032427adb27251a2 --- # Removing the cover photo from the profile URL: https://wpusermanager.com/article/212-removing-the-cover-photo-from-the-profile/ Last updated: 2023-02-18 If you don't want to display the user's cover photo on their profile page then you will need to customize the profiles/cover.php template. First of all, you should learn how the template system works. Read more information in this article Your custom cover.php template should look like this: https://gist.github.com/wp-user-manager/b68f43658b51d2d899ebdcb8bda92303 --- # Change the profile settings header text on the Account page URL: https://wpusermanager.com/article/215-change-the-profile-settings-header-text-on-the-account-page/ Last updated: 2019-11-06 Add the following to an mu-plugin or your theme's functions.php file: https://gist.github.com/wp-user-manager/f6fca7fd28bd80ec8c7b7b3c314fabba Update the text at line 4 to change it to your desired header. --- # Showing a logout link into a theme URL: https://wpusermanager.com/article/167-showing-a-logout-link-into-a-theme/ Last updated: 2019-09-05 Showing a logout url into a theme can be done with the [wp\_logout\_url()](https://codex.wordpress.org/Function_Reference/wp_logout_url) function. This function can be placed anywhere into your theme files and accepts a custom url as optional parameter. If the redirect parameter is not used, users will automatically be redirected to the page you've selected into the settings panel. Example usage: logout and redirect to current page. ``` ``` Example usage: logout and redirect to another page by ID ``` ``` --- # Disable the "remember me" option into the login form URL: https://wpusermanager.com/article/166-disable-the-remember-me-option-into-the-login-form/ Last updated: 2019-09-02 When developing with WP User Manager, you might want to disable and remove the "remember me" checkbox from the login form. In order to achieve this, you can use the `wpum_login_shortcode_args` filter. You can add the following snippet at the bottom of your theme's functions.php file. https://gist.github.com/alessandrotesoro/661f2e2e1bfcb09df652d8bd7c68588e --- # How to hide the field group title and description from profile page URL: https://wpusermanager.com/article/150-how-to-hide-the-field-group-title-and-description-from-profile-page/ Last updated: 2023-02-17 The user public profile page will display the field groups title and description. If for any reason you might want to remove them from displaying, follow these instructions. Before following these instructions make sure you are comfortable and understand how to customize the WPUM template files. Read more here ### Remove the title and description 1. Retrieve the file about.php from the "templates/profile" folder of the plugin. 2. Copy and paste the file into your theme's wpum folder in order to modify it. Please read the above links for more information. 3. Open the about.php file with your favorite code editor and remove the following code: ```

``` Save the file. The description and group title have now been removed. --- # Set maximum upload size for avatars and cover images URL: https://wpusermanager.com/article/146-set-maximum-upload-size-for-avatars/ Last updated: 2019-12-03 It is recommended that you limit the size of the images that your members are able to upload onto your website. In this way you can prevent your users from wasting disk space on your server. In order to set a size limit, add the following line to your theme's functions.php file, or to your wp-config.php file. ``` // Set the avatar image max size define( 'WPUM_MAX_AVATAR_SIZE', 10240 ); // Set the cover image max size define( 'WPUM_MAX_COVER_SIZE', 5242880 ); ``` The above example will set the maximum file size for avatars to 10kb and cover images to5MB. The WPUM\_MAX\_AVATAR\_SIZE and WPUM\_MAX\_COVER\_SIZE constants only accept bytes as a value. Sizes examples: 50kb = 51200 100kb = 102400 1mb = 1048576 You can use a website like this to help you calculate the any size you want --- # How to disable the built-in custom menu controller URL: https://wpusermanager.com/article/137-how-to-disable-the-built-in-custom-menu-controller/ Last updated: 2019-10-09 WPUM comes with a built-in custom menu visibility options. It's possible that sometimes conflicts with other menus related plugins would make WPUM's settings disappear or the third party plugin's settings disappear within your WordPress admin panel menu editor. If you wish to disable the built-in WPUM menu visibility options, you can add the following code to your website's wp-config.php file. You can access the file via ftp through your host. ``` define('WPUM_DISABLE_MENUS_CONTROLLER', true); ``` --- # How to add email confirmation at registration URL: https://wpusermanager.com/article/136-how-to-add-email-confirmation-at-registration/ Last updated: 2019-09-02 The WP User Manager plugin has many filters that allows developers to extend the plugin and add new fields. In some cases you might want to add an email confirmation field so that user can type the email twice to make sure it's correct. The ` wpum_get_registration_fields` filter allows developers to introduce new fields into the registration form. Once the field has been added, you can use the `submit_wpum_form_validate_fields` filter to add new validation rules. The new validation rule is needed so that you can actually verify that both emails are the same. Here's the full code: https://gist.github.com/alessandrotesoro/22de8830219dec313878ce243db0f62a Within the snippets you can feel free to modify the label, description and even the validation error. --- # Create a new tab on the Profile page URL: https://wpusermanager.com/article/223-create-a-new-tab-on-the-profile-page/ Last updated: 2023-03-23 If you are trying to add new content to a user's profile page, you can add a new tab to the profile, and render your custom content using the following code. The code should be added to an mu-plugin file, eg. wp-content/mu-plugins/wpum.php https://gist.github.com/wp-user-manager/8f6a28199450cca0a3a036a41bb09634 --- # How to move the role dropdown to the top of the form URL: https://wpusermanager.com/article/218-move-role-dropdown-to-top-of-form/ Last updated: 2019-12-19 If you want to move the role dropdown to the top of the registration form, add this code to an wp-content/mu-plugins/ file (eg. wp-content/mu-plugins/wpum.php) or your theme's functions.php file: https://gist.github.com/wp-user-manager/750edafae72fd5a0b7022b58a6df3cfd --- # How to add an external link to the Profile page tabs URL: https://wpusermanager.com/article/222-how-to-add-an-external-link-to-the-profile-page-tabs/ Last updated: 2020-02-02 If you want to add a new tab to the Profile page that adds an external link, add the following code to a file in wp-content/mu-plugins (eg. wpum.php) or your theme's functions.php file: https://gist.github.com/wp-user-manager/255daeb154155916fa0b6d0b73a8fc9d (Requires WP User Manager version 2.2.3 or higher) --- # How to change the post type of the Posts displayed on the Profile URL: https://wpusermanager.com/article/235-how-to-change-the-post-type-of-the-posts-displayed-on-the-profile/ Last updated: 2020-09-16 Not every site will have users creating posts, instead they might be creating items in a custom post type, and you want to show those on users profile pages. You can change the 'Posts' tab to change the label and use a different post type to display the items: https://gist.github.com/wp-user-manager/34405d267085b8df038c0b3ca94cf0e3 --- # Remove the user nickname from the Display name dropdown in the Account page URL: https://wpusermanager.com/article/204-remove-the-user-nickname-from-the-display-name-dropdown-in-the-account-page/ Last updated: 2019-10-25 If you want to remove the user nickname selection option in the 'Display name' dropdown on the Account page (or any other option), add this code to an wp-content/mu-plugins/ file (eg. wp-content/mu-plugins/wpum.php) or your theme's functions.php file: https://gist.github.com/wp-user-manager/86bba2f34c0f867da3c88f5228372d33 --- # Redirect the login and register pages for logged in users to the account page URL: https://wpusermanager.com/article/200-redirect-the-login-register-pages-for-logged-in-users-to-account-page/ Last updated: 2019-10-23 When logged in users visit the login or register page they will see a page that says "You are currently logged in as..." with some helpful links. This template can be [customised](https://wpusermanager.com/article/121-templates-customization), but for some these pages aren't necessary. To redirect logged in users who visit the login or register pages to the account page, add this code to your theme's functions.php or to an mu-plugin file inside `wp-content/mu-plugins`: https://gist.github.com/wp-user-manager/24be5c9c96d4d7e3b7dbb8a01e6d3234 --- # User Verification WP-CLI Commands URL: https://wpusermanager.com/article/232-wp-cli-commands/ Last updated: 2020-06-14 Currently the User Verification plugin has the following custom [WP-CLI](https://developer.wordpress.org/cli/commands/) commands: `wp wpum revoke-users` - Revoke approved users, changing their status back to pending. eg. `wp wpum revoke-users --users=1,2,4` `wp wpum resend-verification-email` - Resend verification email to pending users --- # wpum_get_core_page_id() URL: https://wpusermanager.com/article/168-wpumgetcorepageid/ Last updated: 2023-02-28 Retrieves the page ID number of the core pages used by the theme and selected into the admin panel. Information about each page can be found here Supported parameters: - $name - supported options: login, register, password, account, profile **Example usage:** Get login page ID: ``` $login_page_id = wpum_get_core_page_id( 'login' ); ``` Get registration page ID: ``` $registration_page_id = wpum_get_core_page_id( 'register' ); ``` --- # Elementor Widgets URL: https://wpusermanager.com/article/342-elementor-widgets/ Last updated: 2023-03-13 To use Elementor with WP User Manager before version 2.9 you would have needed to use the WPUM shortcodes when building pages with Elementor. Now there are dedicated Elementor widgets for the WPUM shortcodes: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640fa37a3387cb3e147b7803/file-AzUcR4AIQg.png) For example, this is using the Login Form shortcode: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/640fa4583387cb3e147b7804/file-gh0KSeNP5M.png) --- # Registering new template locations URL: https://wpusermanager.com/article/230-registering-new-template-locations/ Last updated: 2020-06-02 By default, WP User Manager will look in your theme directory in the `wpum` folder for any templates you have customized, that will overrdie the default WP User Manager ones. However, if you want to store your templates elsewhere, like in a plugin or mu-plugin, you can tell WP User Manager where they located using this code: https://gist.github.com/wp-user-manager/57b18f07263f4a32e6df97c7bd4041d0 --- # Customizing the email design URL: https://wpusermanager.com/article/124-customizing-the-email-design/ Last updated: 2023-02-17 When building a site or theme with WP User Manager, you will want to customize the email design. Luckily WPUM allows you to do this and it's very easy to do. First of all, you should learn how the template system works. Read more information in this article: Now that you learned how to override the templates, we will have a look at which template files are used by the emails. By default, all emails sent through WPUM will use the template selected by the admin in *Users > Settings > Emails.* If you wish to modify these template files in any way, simply copy the *emails* folder to a folder called *wpum* in your theme and then modify them. Templates Usage: ---------------- - [emails](https://github.com/wpusermanager/wp-user-manager/tree/master/templates/emails)/**header.php:** used when the "no template, plain text only" option is selected into the admin panel. - [emails](https://github.com/wpusermanager/wp-user-manager/tree/master/templates/emails)/**body.php:** used when the "no template, plain text only" option is selected into the admin panel. - [emails](https://github.com/wpusermanager/wp-user-manager/tree/master/templates/emails)/**footer.php:** used when the "no template, plain text only" option is selected into the admin panel. - [emails](https://github.com/wpusermanager/wp-user-manager/tree/master/templates/emails)/**header-default.php:** used when the "default template" option is selected into the admin panel. - [emails](https://github.com/wpusermanager/wp-user-manager/tree/master/templates/emails)/**body-default.php:** used when the "default template" option is selected into the admin panel. - [emails](https://github.com/wpusermanager/wp-user-manager/tree/master/templates/emails)/**footer-default.php:** used when the "default template" option is selected into the admin panel. --- # Customizing the user directory template URL: https://wpusermanager.com/article/123-customizing-the-user-directory-template/ Last updated: 2023-02-17 A lot of times when building a site or theme with WP User Manager, you will want to customize the template of the user directory. Luckily WPUM allows you to do this and it's very easy to do. First of all, you should learn how the template system works. Read more information in this article: Now that you learned how to override the templates, we will have a look at which templates are used by the user directory. Main Directory Template ----------------------- templates/ **directory.php** The directory.php file, is the template file responsible to handle the display of a directory. **You should only modify the code between this line** ``` ``` and this line ``` ``` Please do not remove calls to the do\_action() function within this file. The plugin itself and the addons will make use of these actions, removing those lines will break the plugin and it's addons. Single User Template -------------------- /directory/ **single-user.php** The main directory template file loads an additional file called "single-user". This file is used to display the detail of each individual user found within the directory. Top Bar Template ---------------- directory/ **top-bar.php** Each directory has the ability to display a "sort" field and an "amount modifier" field. It also displays the total amount of users that have been found for that directory. --- # Example template customization URL: https://wpusermanager.com/article/122-example-template-customization/ Last updated: 2019-09-02 Now that you've learned how to customize the templates and where to find them, let's make a small test modification. In this example we will add some custom text above the registration form. Remember this is just a very simple example, custom text can obviously be added through the WordPress page editor. 1 Navigate to the wp-content/plugins/wp-user-manager/templates/ folder on your server. ( You should connect via FTP or any other way you use to access your files ) 2 You will notice files and sub folders. The registration form template file can be found into the subfolder "**forms**". 3 Open the subfolder "**forms**" and copy the file **registration-form.php** 4 Now navigate to your theme's folder - for example **wp-content/themes/twentyfifteen** 5 Create a new folder called "**wpum**" if it does not exist. 6 Because the **registration-form.php** file was into a subfolder called "**forms**" - you must create a new folder called "**forms**" into your "**wpum**" folder. 7 Now paste the registration-form.php file that you have previously copied. Your structure should now look like this![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c92c7d3a7a4d77f528/5d6cf2c319c49.png) 8 Open up the file with your favorite code editor and add or modify the content of the file. In this example i've simply added a custom phrase at the top of the form:![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ca2c7d3a7a4d77f529/5d6cf2c353ed9.png) Save the file and visit your registration page ( remember the registration form is visible only when NOT logged in ) and if you've done everything correctly, you will see your custom phrase on top of the form. ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2ca2c7d3a7a4d77f52a/5d6cf2c399361.png) --- # Templates customization URL: https://wpusermanager.com/article/121-templates-customization/ Last updated: 2019-09-02 WP User Manager is designed to work right out of the box with most WordPress themes. It does this by using a template hierarchy system in the same way WordPress does. Furthermore the plugin comes with a very minimalistic layout so that it can easily be adapted/modified to your theme. WPUM allows you to make any kind of modifications to the template files of the plugin. In this way you can make minor or major modifications to any template used by WPUM. ### How files are loaded WP User Manager uses a fallback template system, it works the same way the WordPress theme files do. 1. If a child theme is installed on your website, WPUM will look for it's templates into your child theme first. 2. If a child theme is installed but does not have any WPUM templates, it will search into your parent theme. 3. If no child theme is installed, WPUM will search into your main theme only. 4. If no templates are found into your theme, WPUM will use it's default templates that come with the plugin. ### How to customize the templates In order to customize the templates of the plugin you need to create a new folder called "wpum" (without the quotes) into your custom theme's folder. Example, if your theme is "Twenty Fifteen", your theme's folder will be in ``` wp-content/themes/twentyfifteen ``` Now create a new folder called "wpum" into the "twentyfifteen" folder. See screenshot below: ![](https://s3.amazonaws.com/helpscout.net/docs/assets/5d6cea4404286350aeeb5235/images/5d6cf2c904286350aeeb52e8/5d6cf2c27fb24.png) You can now copy any of the template files of WP User Manager, into the "wpum" folder of your theme. The template files of the plugin can be found in folder ``` wp-content/plugins/wp-user-manager/templates/ ``` on your server. You must follow the same file/folder names and placement into your theme's folder. ### What you should never do You shouldn't under any circumstance remove any call to the do\_action() WP function within the template files. If you do, you will break addons functionalities in some cases. --- # Customize the user profiles URL: https://wpusermanager.com/article/105-customize-the-user-profiles/ Last updated: 2023-02-17 A lot of times when building a site or theme with WP User Manager, you will want to customize the users public profile page. Luckily WPUM allows you to do this and it's very easy to do. First of all, you should learn how the template system works. Read more information in this article Now that you learned how to override the templates, we will have a look at which templates are used by the profile page. Templates Usage: ---------------- #### profile.php Is the template file that displays all the content within the profiles pages. #### profiles/about.php This file loads the content of the "about" tab within the profiles page. This contains the list of all the user's fields. #### profiles/comments.php Displays a list of the comments submitted by the user. #### profiles/cover.php Displays the cover pictures of the user. #### profiles/intro.php Displays the user's avatar, name and description. #### profiles/navigation.php Displays the links to the tabs of the profile page. #### profiles/posts.php Displays the posts submitted by the user.