Getting the most out of Flexa Unsubscribe

Once the plugin is activated you’ll find a new Unsubscribe item in the WordPress admin menu on the left. Everything in this guide lives under that menu.

1. In the WordPress admin sidebar, click Unsubscribe. It sits in the lower group of the menu, near Settings.
2. The plugin opens on its Dashboard. The sub-tabs along the top - Dashboard, Unsubscribes, Blocked Emails, Re-subscribed, Reasons, Settings, Appearance - are the seven screens covered below.

The Dashboard is your at-a-glance health check: how many people have opted out, how many sends were blocked, and the trends over time.

You’ll see:

• Summary cards - totals for unsubscribes, blocked attempts and re-subscribes.
• Over-time chart - unsubscribes plotted by date so you can spot spikes after a campaign.
• By-reason chart - why people are leaving, drawn from the reasons you configure later in this guide.

This is the one screen you must visit to make the plugin do anything. Open the Settings tab.

1. Turn on Auto-append unsubscribe link so a one-click unsubscribe button is added to outgoing emails that go to a single recipient.
2. Turn on Block unsubscribed recipients so the plugin refuses to send to anyone who has opted out. Every blocked attempt is logged (see Blocked Emails).
3. Review Exclude keywords. Any email whose subject contains one of these words (case-insensitive) skips both blocking and the appended footer. The default - Order, Password, Invoice - keeps transactional mail like receipts and password resets flowing. Add your own, comma-separated.
4. Click Save changes. The button stays disabled until you’ve actually changed something, and an “Unsaved changes” hint appears while edits are pending.

On the same Settings screen, the “Unsubscribe footer” block controls exactly what the appended button looks like in the emails your recipients receive.

Edit any of the three, click Save changes, and send yourself a test email to confirm it looks the way you want.

When someone clicks the button, they land on a page hosted by your site. The Appearance tab lets you match it to your brand - with a live preview so you see every change instantly.

You can adjust:

• Colours - page background, card background, text, headings and the action button (normal + hover).
• Typography - font family (choose from a short list) and base font size.
• All the wording - the page title, the confirmation message, the feedback button, the thank-you text, the “back to home” link, and the messages shown for expired links and successful re-subscribes.

1. Change a colour, font or piece of text on the left.
2. Watch the live preview on the right update as you type.
3. Click Save changes when you’re happy.

The Unsubscribes tab is the master list of every address that has opted out, the reason they gave (if any), and when.

• Search the list instantly as you type.
• Sort by clicking a column header (email, reason, date).
• Paginate through large lists. The page, sort and order are stored in the URL, so you can bookmark or share an exact view.
• Delete a row if you need to remove someone from the opt-out list manually (they’ll start receiving mail again).

This is an audit log of send attempts that were stopped because the recipient had opted out - it is not the opt-out list itself.

Each entry records the recipient, the email subject, who it was from, and when the send was blocked. Use it to confirm the plugin is doing its job, or to investigate “why didn’t my customer get that email?”.

• Search, sort and paginate just like the Unsubscribes list.
• Delete a single log entry, or use the clear action to empty the whole log.

People who opted out can opt back in via a re-subscribe link. When they do, their row isn’t deleted - it’s marked re-subscribed and shown here.

This screen lets you see who changed their mind and when, which is handy for measuring whether a win-back campaign worked. Same search / sort / pagination controls as the other lists.

On the Reasons tab you decide which choices people see when they unsubscribe. Their selection feeds the “by reason” chart on the Dashboard.

1. Add a reason by typing it and saving - it starts with three sensible defaults.
2. Edit the wording of any reason in place.
3. Reorder them so the most likely reasons appear first.
4. Delete any you don’t want to offer.

The Unsubscribes, Blocked Emails and Re-subscribed lists each have an Export CSV button. It downloads the full list as a spreadsheet you can open in Excel, Google Sheets or your CRM.

On the Unsubscribes screen, the Import CSV button (next to Export CSV) lets you bulk-add opt-out records from a spreadsheet - handy when you’re migrating from another tool or seeding a new site from an existing export.

1. Click Import CSV. A dialog opens with a file-picker and a link to download a sample CSV.
2. Choose a CSV file. The expected columns are Email (required), Reason (optional) and Date (optional). A header row is auto-detected - so the file you got from the Export button re-imports cleanly. Headerless files work too: if the first cell is an email, columns are read by position.
3. Click Import. After a few seconds you’ll see a summary: how many rows were imported, how many were skipped (because the email was already opted out), and how many failed (e.g. an invalid email) - with the row number for each failure so you can fix the file.

• Limits. Up to 2 MB per file and 10,000 rows per import. For larger lists, split the file and import each piece.
• Missing Date. If a row has no Date, the import uses the current time.
• Permissions. Same as Export - only users with the manage_options capability (administrators) can import.

Need the technical details (REST API, hooks, database schema)? See the technical documentation.