Fresh Install
Overview
Setting up Meta Membership on a new site is straightforward. This guide walks you through the essential steps from installation to a working membership site.
If you are migrating from an existing membership plugin, see [Migrating from Another Plugin] instead.
Before you start
If you intend to take payments via Stripe, install and configure Minimal Stripe Wrapper first. Meta Membership will detect it automatically once active.
1. Install & activate
Install Meta Membership from WordPress.org or upload the plugin zip via Plugins > Add New > Upload Plugin. Activate it through the Plugins menu.
For detailed instructions, refer to the official WordPress plugin installation guide:
πΒ Installing Plugins in WordPress
2. Create the member dashboard page
Create a new WordPress page and add the [mime_dashboard] shortcode. Publish the page.
Meta Membership will automatically detect this page and use it for member redirects after login, registration, and payment. No further configuration is needed. Detection works with standard WordPress pages and all major page builders including Divi, Elementor, and Beaver Builder.
Note: If no dashboard page is found, a warning notice will appear on Meta Membership admin screens as a reminder. You can also set the dashboard page manually under Meta Membership Settings > GeneralΒ if you prefer not to use auto-detection.
3. Configure general settings
Go to Meta Membership Settings > General and review the system-wide defaults. Key decisions at this stage:
Renewal Mode β choose between:
- Anniversary β membership expires a set period after the join date
- Fixed Expiry β all memberships of this type expire on the same date each year (e.g. 1 April)
- Never Expires β membership does not expire
Registration Policy β choose between:
- Open β anyone can register
- Admin Approval β registrations are held for admin review before activation
- Admin Only β only admins can create member records
Grace Period β the number of days after expiry during which a member retains access while they renew. Defaults to 30 days.
Currency β set your default currency here.
Admin Recipients β the email address(es) that receive admin notifications.
These are system-wide defaults. Each membership type can override them individually.
4. Add custom member fields (optional)
If you need to collect additional information beyond name and email β address, phone, custom checkboxes, or other fields β go to Meta Membership Settings > Member Meta FieldsΒ and define your fields before creating membership types.
Available field types: Text, Text Area, Select, Multi Select, Checkbox Group, Radio Button Group, Phone, URL, Date.
π Important: Note the field slug for each field you create. If you plan to import members via CSV, the column headers in your CSV file must match the field slugs exactly.
5. Create membership types
Go to Memberships > Membership TypesΒ and click Add New. Create at least one membership type.
For each type configure:
- Name β this is also used in the CSV import file
- Registration FeeΒ β set to 0 for free membership
- Renewal Fee β set to 0 if same as registration fee.
- Renewal Mode β override the system default if needed
- Fixed Expiry Date β override the system default if needed
- Pro-rata β optionally apply a proportional discount for members joining mid-period (fixed expiry only)
- Grace Period β override the system default if needed
- Registration Policy β override the system default if needed
- Payment Gateways β override the system default if needed
- Meta Fields β assign your custom fields to the Profile and/or Registration forms for this type
Once saved, the Membership Types table displays the registration form shortcode for each type. Use the copy-to-clipboard button to get the exact shortcode.
6. Create registration page(s)
[mime_registration type="your-membership-type-slug"]
Publish the page and link to it from your site navigation or a call-to-action.
Admin-only membership types do not need a registration page.
7. Set up notifications
Meta Membership has two distinct notification systems:
System Notifications
(Meta Membership Settings > Notifications) are triggered automatically by system events β payment completed, registration approved, password reset, membership onboarding, and more. These come pre-configured with sensible defaults. You can edit the subject and body of each notification but cannot add new trigger types.
Membership Notifications
(Membership > Membership Notifications) are time-based reminders you configure yourself β for example, a reminder 3 weeks before expiry, another 2 weeks before, and a notification on the day of expiry. You can add any number of notifications and target them to specific membership types or all memberships.
Both systems support a Variable Inserter for personalising email content with member name, site name, expiry date, and other dynamic values.
8. Enable payment gateways
Go to Meta Membership Settings > Payments and enable the gateways you want to offer:
Stripe β via Minimal Stripe Wrapper (must be installed separately)
Manual Payment β for members who pay by bank transfer, cash, or cheque
POLi β NZ internet banking, via Meta Poli Payments add-on (NZ only)
9. Role Sync Rules (optional)
If you are using other plugins that rely on WordPress roles β such as [Ultimate Member] β go to Meta Membership Settings > Role Sync Rules and map membership types and statuses to WordPress roles. This keeps WP roles aligned with membership status automatically.
This step is not required for Meta Membership’s own access control, which works independently of WP roles.
You're ready
With a dashboard page, at least one membership type, a registration page, and notifications configured, your membership site is functional. Members can register, pay, and manage their membership from the dashboard.