Installation
New to WordPress? Read Your WordPress admin right after install — it maps every menu item under Easy Invoice to the page in these docs.
Requirements
- WordPress 5.6+
- PHP 7.4+ (the bundled
composer.jsonis stricter than the readme — use the readme value for compatibility) - A WordPress site with Pretty permalinks enabled (Settings → Permalinks → anything other than Plain)
- For Pro: an active Easy Invoice Pro license from your MatrixAddons account
Easy Invoice Pro requires the free Easy Invoice plugin to be active. Activating Pro without Free triggers a
wp_dieand auto-deactivates Pro — seeeasy-invoice-pro.php:184–211.
1. Install the free plugin
The free plugin is the foundation. Install it first.
From WordPress.org (recommended)
- Open Plugins → Add New.
- Search for Easy Invoice by MatrixAddons.
- Click Install Now, then Activate.
From a ZIP
- Download
easy-invoice.zipfrom wordpress.org/plugins/easy-invoice. - Open Plugins → Add New → Upload Plugin.
- Choose the ZIP, click Install Now, then Activate.
You should see a new top-level Easy Invoice menu item in the WordPress sidebar.
2. Install Easy Invoice Pro (optional)
Pro is delivered as a separate plugin ZIP from your MatrixAddons account.
- Sign in at matrixaddons.com/account.
- Download easy-invoice-pro.zip from Downloads.
- In WordPress, open Plugins → Add New → Upload Plugin.
- Upload the ZIP, click Install Now, then Activate.
Activate your Pro license
- Open Easy Invoice → License.
- Paste your license key (from your MatrixAddons account → Licenses).
- Click Activate.
The license activates against https://store.mantrabrain.com/edd-sl-api/? — see Troubleshooting if your host firewalls outbound HTTPS.
3. Set permalinks
Easy Invoice rewrites URLs for invoice and quote singles. Without pretty permalinks, links 404.
- Open Settings → Permalinks.
- Pick Post name (or any non-Plain).
- Click Save Changes.
Pro also adds a Permalinks tab in Easy Invoice → Settings for custom & secure link slugs — see Pro features overview.
4. Verify the install
Quick sanity check that everything loaded:
| Check | Where | Pass |
|---|---|---|
| Free plugin active | Plugins → Installed Plugins | "Easy Invoice" listed and active |
| Top-level menu | WordPress sidebar | "Easy Invoice" visible with submenus |
| Pretty permalinks | Settings → Permalinks | Anything except "Plain" |
| Pro active (if installed) | Easy Invoice → License | Status: Active |
| First invoice URL | Easy Invoice → Add New → Save | Public link opens the invoice template |
5. (Optional) Run the setup walkthrough
Easy Invoice doesn't ship a separate wizard — instead, the Quick start page walks you through:
- Company details (name, address, logo for invoice header)
- Currency & decimal precision
- Invoice numbering (prefix + auto-increment)
- The first email template
- The first PayPal connection
- Sending the first invoice
Updating
- Free: WordPress.org auto-updates apply via Plugins → Installed Plugins.
- Pro: After license activation, Pro updates show up in the same Plugins screen. The license must be active for update notifications to appear.
Where next
- 🚀 Quick start — your first invoice in five minutes.
- 🧭 Your WordPress admin — what every menu item does.
- 🧾 Invoices — the builder, taxes, discounts, and PDF export.