Welcome & Onboarding Flow

Applies to: WordPress Plugin

Where: WP Admin > Compliance (top-level menu, opens automatically on first activation)

Overview

When you install and activate the Compliance by Hu-manity.co plugin for the first time, a setup wizard (the Welcome Modal) opens automatically. This wizard guides you through choosing a protection level and connecting your site.

The WelcomeModal also reopens automatically for unconnected users who have not completed setup, or after 30 days since the last dismissal.

When the WelcomeModal Opens

The WelcomeModal appears in these situations:

First activation — After activating the plugin, WordPress redirects to the plugin settings page with the Welcome Modal open.
First visit (no prior dismissal) — If the plugin has never been connected and you have not dismissed the modal before, it opens on your next visit to the plugin settings page.
30-day re-prompt — If you dismissed the modal more than 30 days ago and your site is still unconnected, the modal reopens.

You can also open the WelcomeModal manually from the Protection tab by clicking the activation button on the Compliance Grade panel.

Step 1: Choose Your Protection Level

The first screen presents three protection level options:

Option	What It Includes	Cost
Banner Only	A display-only cookie notice banner with accept/reject buttons. Does not include compliance features (no consent records, no autoblocking, no audit trail, no Google Consent Mode).	Free
For small sites (Recommended)	Essential compliance with no credit card required. Includes Google Consent Mode v2, tracker blocking, and standard support. Up to 1,000 visits/month.	Free
Ensure full compliance (Full Compliance)	Full coverage for EU, US & growing businesses. Includes Google, Facebook & Microsoft Consent Modes, geolocation rules, lifetime audit trail & consent records, advanced autoblocking, and priority support. Unlimited visitors protected.	$14.95/month

If Google tools (such as Google Analytics or Google Tag Manager) are detected on your site, a notice appears reminding you to configure Google Consent Mode during setup.

If you select Banner Only, a liability warning screen appears. This screen explains what you will not have without full compliance features:

Consent records — no proof if a regulator asks
Cookie autoblocking — scripts fire before consent
Audit trail — no evidence if investigated
Google Consent Mode — EU ads may be flagged

You must check the acknowledgment checkbox before you can proceed. After confirming, the modal closes and you are taken to the Settings tab where you can configure your banner-only setup.

Step 2: Confirm Plan Details

If you selected Ensure full compliance (Professional plan), a plan details screen lets you choose your billing configuration:

Domain count: 1, 5, or 10 domains
Billing cycle: Monthly or Yearly (annual billing saves 17%)

Pricing tiers (verified in code):

1 Domain: $14.95/mo or $149.50/yr
5 Domains: $29.95/mo or $299.50/yr
10 Domains: $49.95/mo or $499.50/yr

Annual billing saves 17%. After selecting your plan, click the action button to proceed to account creation.

If you selected For small sites (Free plan), this step is skipped and you proceed directly to account creation.

Step 3: Create Account

The account creation step connects your WordPress site to the Cookie Compliance service. You can either:

Create a new account — Enter your email, password, confirm password, and accept the terms of service.
Log in to an existing account — If you already have a Hu-manity.co account, switch to the login form and enter your credentials.

After account creation/login

What happens next depends on your account state:

Free plan, no existing subscriptions: The page reloads and the plugin is now connected. The WP admin displays all three tabs (Protection, Settings, Audit Trail) with full functionality.
Professional plan selected: You proceed to a payment step to complete your subscription via the payment form.
Existing subscriptions with available licenses: A license selection step appears where you can assign an available license from one of your existing subscriptions instead of purchasing a new one.

After Setup

Once the WelcomeModal completes:

Your site is connected to the Cookie Compliance service (an app_id is assigned).
The plugin automatically fetches your banner configuration from the portal.
The consent banner begins appearing on your site's front end.
You can manage settings through both the WordPress admin and the Admin Portal at app.hu-manity.co .

Troubleshooting

Welcome Modal does not appear

Navigate to Compliance (top-level menu) in your WordPress dashboard. If the plugin is already connected, the Welcome Modal will not open.
If you need to reconnect, deactivate and reactivate the plugin, or visit the plugin settings page with ?cn_react_welcome=1 appended to the URL.

Account creation fails

Verify your email address is valid and not already registered.
Check that your WordPress site can reach designer-api.hu-manity.co (some security plugins or server firewalls may block outbound API requests).

React Admin Overview — Walkthrough of the three admin tabs available after setup.
Portal vs WP Admin: What Lives Where — Understand which settings are in the WP admin versus the Admin Portal.
Where is my App-ID and Secret Key? — For manual connection scenarios (multisite, reconnection).