Installation and activation
3 min read
Install the free plugin
From the WordPress directory
- In wp-admin go to Plugins › Add New Plugin.
- Search for Massbase Custom Fields (author: WPMass) and click Install Now.
- Click Activate.
From a zip file
- Go to Plugins › Add New Plugin › Upload Plugin.
- Choose the zip and click Install Now, then Activate Plugin.
Or upload the massbase-custom-fields folder to /wp-content/plugins/ and activate it on the Plugins screen.

What activation does
When you activate the plugin it:
- Creates its core database tables (with your table prefix, shown here as
wp_):
Table | Holds |
|---|---|
| Field group, post type, taxonomy and options page definitions, Global Data and plugin settings |
| Which database upgrades have run |
| Background tasks |
| The log of those tasks |
Field group tables (wp_wpmcf_fg_{group key}) are created later, when you create a field group. With Pro, extra tables appear for Programmatic SEO and data tables.
- Resumes any background work that was paused when the plugin was last deactivated.
- Refreshes your URLs (rewrite rules) so custom post types work.
- Opens the setup wizard once, on the next admin page load (see below).
Running activation again is safe; it does not duplicate or overwrite anything.
After an update, the plugin checks once whether the database needs an upgrade and runs it in the background. You do not need to deactivate and reactivate.
The setup wizard opens by itself, once
After a single activation, the next wp-admin page you open redirects to Massbase › Setup (wp-admin/admin.php?page=wpmcf-setup). It does not open when:
- you activated several plugins at once (bulk activation),
- you activated the plugin for the whole network,
- the wizard was already finished or skipped,
- the request is not an administrator's.
Details: Setup wizard and starter templates.
Install Massbase Custom Fields Pro
Massbase Custom Fields Pro is a separate plugin package (massbase-custom-fields-pro). After you buy a plan or start a trial (from the Get Pro page of the free plugin, or from Settings › Plan & license › Plans and pricing in the Pro plugin), the confirmation email contains your license key and a download link; you can download Pro again at any time from your Freemius customer account.
- Go to Plugins › Add New Plugin › Upload Plugin and upload the Pro zip.
- Activate it. Activating Pro deactivates the free plugin by itself, so only one copy runs. Once Pro works you can delete the free plugin.
- Enter your license key when asked (see Plans and licensing).
Everything you built with the free plugin is picked up as it is: field groups, tables, settings and post types are shared. The first admin page load after installing Pro adds the extra Pro tables automatically.
Go back from Pro to free
Install and activate the free plugin in place of Pro. Nothing is deleted: Pro data stays in your database, advanced field values keep printing, and Pro screens simply disappear. See Trials, renewals and expiry for what happens to each Pro feature.
Troubleshooting
Symptom | What to do |
|---|---|
The setup wizard did not open | Open it yourself at Massbase › Setup ( |
"Plugin could not be activated because it triggered a fatal error" | Check your PHP version in Requirements. If the version is fine, ask in the support forum and include the error. |
Massbase menu is missing | Only users with the |
Tables were not created | Your database user may lack |
Still stuck? Contact support