---
title: "[ms-membership-register-user]"
source: "https://docs.nexcess.com/software/learndash/memberdash/ms-membership-register-user/"
description: "The [ms-membership-register-user] shortcode displays a user registration form. This form allows visitors to create a WordPress user account and optionally be ad…"
vertical: "Software"
area: "MemberDash"
topics: ["MemberDash", "Memberships", "Settings", "Shortcodes", "User Guides"]
date: "2024-03-13"
last_modified: "2026-07-02"
---

# [ms-membership-register-user]

The **\[ms-membership-register-user\]** shortcode displays a user registration form. This form allows visitors to create a WordPress user account and optionally be added to a membership.

**Note**: If a registered user is already logged in when they visit the registration page with this shortcode \[ms-membership-register-user\], they will be automatically redirected to the Membership List page. The Membership List page is defined under MemberDash > General Settings, in the Membership Pages section on the same screen.

## **Shortcode Parameters**

### **General Settings**

| **Parameter** | **Type** | **Description** | **Default** | **Example** |
|---|---|---|---|---|
| title | Text | Title displayed above the form | Create an Account | title=”Join Now” |
| first\_name | Text | Pre-filled first name in the form |  | first\_name=”Jane” |
| last\_name | Text | Pre-filled last name in the form |  | last\_name=”Doe” |
| username | Text | Pre-filled username in the form |  | username=”janedoe” |
| email | Text | Pre-filled email address |  | email=”jane@example.com” |
| membership\_id | Text | Assigns the user to a membership. Hidden from users. ⚠️ If the membership requires payment, users are redirected to checkout after registering. |  | membership\_id=”123″ |
| loginlink | yes / no | Shows or hides the login link below the form | yes | loginlink=”no” |

###   
Field Labels**

Customize the text shown next to each form field.

| **Parameter** | **Type** | **Description** | **Default** | **Example** |
|---|---|---|---|---|
| label\_first\_name | Text | Label for the First Name field | First Name | label\_first\_name=”Given Name” |
| label\_last\_name | Text | Label for the Last Name field | Last Name | label\_last\_name=”Surname” |
| label\_username | Text | Label for the Username field | Choose a Username | label\_username=”Username” |
| label\_email | Text | Label for the Email field | Email Address | label\_email=”Email Address” |
| label\_password | Text | Label for the Password field | Password | label\_password=”Create Password” |
| label\_password2 | Text | Label for the Confirm Password field | Confirm Password | label\_password2=”Repeat Password” |
| label\_register | Text | Label for the submit button | Register My Account | label\_register=”Sign Up” |

###   
  
  
Field Placeholders (Hints)**

These parameters allow placeholder text to appear inside each input field.

| **Parameter** | **Type** | **Description** | **Example** |
|---|---|---|---|
| hint\_first\_name | Text | Placeholder for First Name field | hint\_first\_name=”Jane” |
| hint\_last\_name | Text | Placeholder for Last Name field | hint\_last\_name=”Doe” |
| hint\_username | Text | Placeholder for Username field | hint\_username=”choose-a-username” |
| hint\_email | Text | Placeholder for Email field | hint\_email=”email@example.com” |
| hint\_password | Text | Placeholder for Password field | hint\_password=”At least 8 characters” |
| hint\_password2 | Text | Placeholder for Confirm Password field | hint\_password2=”Re-type your password” |

## **Examples**

1. Basic registration form with default fields:  
    \[ms-membership-register-user\]

2. Custom title and hint for the email field:  
    \[ms-membership-register-user title=”Join Our Community” hint\_email=”email@example.com”\]