Most questions about the add-on have a one step answer. Find the message or what you see, then follow the steps.
The add-on says it requires the Free Consumer Reports plugin:
Install and activate Free Consumer Reports, then reload the page.
The add-on says no licence on this site includes it:
- Click Add your Funnel Builder key in the note. It opens the License panel.
- Paste the Funnel Builder key (not a report niche key) and click Add another key.
- If the key is there and the note stays, click Refresh License Info.
- If the add-on's files were edited, it switches itself off. Delete it and install a fresh copy from your account.
The tab says Funnel Builder UPGRADE, or the menu items are missing:
The add-on is not active or its key is not added yet. Activate it under Plugins, then add your Funnel Builder key.
Diagnostics says the add-on is installed but no licence includes it:
Add your Funnel Builder key in the License panel. When it is in place, the row says Active v1.0.4 and the tab bar shows Funnel Builder ACTIVE.
A custom funnel shows a 404 page:
- On Diagnostics, check Permalinks says Enabled. If not, go to WordPress Settings, then Permalinks, choose Post name and click Save Changes.
- Check the funnel is switched on. My Custom Funnels shows its Status. Switch it on in the Funnels tab.
- Check your licence includes its category. With keys for some niches, build the funnel again in one of those niches.
- Go to WordPress Settings, then Permalinks, and click Save Changes once more, even if Post name is already chosen.
Creating a category says the slug conflicts with a built-in category:
The name turns into one of the 8 niche slugs, for example Health. That niche is already there to use. For a separate category, choose a different name, for example Health Tips.
Saving says it could not create the funnel directory:
WordPress needs to write to your uploads folder. On the Diagnostics tab, look at the uploads folder under Critical Plugin Files. If it says Missing or Not writable, ask your host to make wp-content/uploads writable.
Saving says the PDF download did not work:
Your site could not fetch the PDF from that link. Use a direct, public link to the file, or upload the PDF in Step 2. The same goes for a cover image link.
Saving says the selected PDF attachment does not exist:
The file was removed from the Media Library. Go back to Step 2 and choose the PDF again.
Saving says a PDF source is required:
Go back to Step 2 and choose a PDF or paste a link. When you edit a funnel, this only shows if it has no PDF on file yet.
A screen says Security check failed:
The page was open a long time. Reload it and try again.
The CSV import says only CSV files are accepted:
Save the file as .csv, not .xlsx or .numbers.
The CSV import says required columns are missing:
Row 1 of the file must be the header row, with title, category, headline, cta_text and pdf_url spelled exactly like that. Files use commas, not semicolons.
The CSV import says the file is empty or has no headers:
Check you picked the right file and that it was saved.
A CSV row needs a fix:
Fix the row in your file and click Upload & Validate again.
- "Title is empty.", "Category is empty.", "Headline is empty.", "CTA text is empty." or "PDF URL is empty.": fill in that cell.
- "PDF URL is not a valid URL.": the link must start with http:// or https://.
- "Accent color is not a valid hex color.": use # and 3 to 8 hex digits, for example #10b981.
- The template name is not recognised: use one of the 9 template names exactly as listed. See Funnel Builder: CSV Columns And An Example Row.
The CSV import says no validated data was found:
A checked file is kept for one hour and is used up by an import. Click Upload & Validate again, then import.
A CSV category shows as new but I meant an existing one:
The category column takes a slug (health) or a name (Health & Fitness), in any letter case. A name that matches neither, for example because of a typo, is treated as new. Fix it in your file and click Upload & Validate again.
Opt-ins from a custom funnel do not reach my list:
Custom funnels use the main plugin's autoresponder settings. Check the Autoresponders tab and the funnel's Edit page (Settings on My Custom Funnels). On Diagnostics, "Default Autoresponder: Not set" or "Default List ID: Not set" means no default is chosen yet. See Connecting Your Autoresponder.
Diagnostics lists a caching plugin under Detected Potential Conflicts:
Leave your funnel addresses (/reports/ by default) out of that plugin's cache, as the Diagnostics note says.
Diagnostics suggests a longer execution time:
Large CSV imports and PDF links need time. Ask your host to raise Max Execution Time, or import in smaller batches.
A category stays after Delete:
A funnel still uses it. Move or delete the funnels in that category first. The Funnels column counts switched on funnels, so a switched off funnel can also be using it.
A funnel has no cover picture:
Click Edit next to the funnel on My Custom Funnels, add a cover in Step 3 and click Update Funnel.