Funnel Builder Add-on: What It Does
The Funnel Builder is an add-on for the Free List Building Website plugin. It lets you make your own opt-in funnels and run them next to the 96 funnels that come with the plugin.
Every funnel you build gets:
- A squeeze page (the opt-in page)
- A download page with a button to your PDF
- Your own PDF lead magnet, stored on your site
- A cover image, if you add one
- Privacy Policy, Terms and Disclaimer pages, linked in the footer
What you can do with it:
- Build one funnel at a time with a 6 step wizard
- Build many funnels at once from a CSV file
- Add your own categories, and change the emoji and badge colour of the built-in ones
- Choose from 9 page templates: Gradient, Clean Card, Dark Professional, Bold Vibrant, Minimal, Modern Glass, Neon Cyber, Warm Sunset and Corporate Blue
- Use those same 9 templates on your 96 built-in funnels
Your custom funnels work like the built-in ones. They use the same autoresponder, the same web address prefix, the same on/off switch on the Funnels tab, and they show on your Showcase page in their category.
Funnel Builder: Requirements, Install and Activate
Before you start:
- WordPress 5.6 or later and PHP 7.4 or later.
- The Free List Building Website plugin installed, activated and licensed. The add-on does nothing on its own.
- Permalinks set to Post name (Settings > Permalinks). Funnel pages do not open with Plain permalinks.
- Your autoresponder connected in the main plugin. Custom funnels send opt-ins to the same place as your built-in funnels.
- An administrator login.
- Your PDF lead magnet, as a file or as a direct link to the PDF.
- Optional: a cover image, square or portrait, at least 400 by 400 pixels.
There is no separate licence key for this add-on. Your Free List Building Website licence is all you need.
Install and activate:
- Log in to your members area and click Download the Funnel Builder add-on. You get flbw-funnel-builder.zip. Do not unzip it.
- Make sure the Free List Building Website plugin is already installed and active.
- In WordPress go to Plugins > Add New > Upload Plugin.
- Choose the zip file and click Install Now, then Activate Plugin.
- Open the Free List Building menu. You now see four new items: Funnel Builder, CSV Import, My Custom Funnels and Categories.
How to check it worked:
- The plugin’s tab bar shows Funnel Builder ACTIVE on the right.
- The Diagnostics tab shows FLBW Funnel Builder Addon: Active v1.0.11.
Updates arrive in Dashboard > Updates, like any other plugin.
Funnel Builder: The My Custom Funnels Screen
Open it from Free List Building > My Custom Funnels, or click the Funnel Builder ACTIVE tab on the right of the plugin’s tab bar.
The first time, you see two cards. Create New Funnel (Start Wizard) opens the wizard. Import from CSV (Upload CSV) opens CSV Import. There is also a Manage Categories link at the bottom.
Once you have funnels, the screen shows:
- Two counters: Total Custom Funnels and Enabled.
- Buttons: + Create New and Import CSV.
- A Search funnels box that filters the table as you type.
- A table with Cover, Title (with its web address under it), Category, Template, Created, Status and Actions. The newest funnel is at the top.
The action buttons:
- Edit opens the funnel in the wizard, with everything filled in. Change the text, PDF, cover image, template or colours, then click Update Funnel.
- Settings opens the funnel’s page in the main plugin, the same page you use for built-in funnels. There you can set the autoresponder and list for this funnel, change the headline, background colour or page template, and set a per-funnel affiliate link.
- Delete opens a box called “Delete this funnel?”. Click Delete Funnel to remove the funnel and all its files: squeeze page, download page, PDF and cover. This cannot be undone.
To switch a custom funnel off or on, use its switch on the main plugin’s Funnels tab, next to your built-in funnels. New funnels are switched on as soon as you save them. The Status column shows Enabled or Disabled.
Funnel Builder: The 6 Step Wizard
Open it from Free List Building > Funnel Builder, or click + Create New on My Custom Funnels. The six steps show across the top: Basic Info, Upload PDF, Cover Image, Choose Template, Customize, Preview & Save. Use Next and Back at the bottom to move between them. Back to Funnels at the top takes you to My Custom Funnels.
Step 1, Basic Info:
- Funnel Title (required). The funnel’s name, used on the pages and in the admin.
- URL Slug. Fills in from the title, or type your own. It shows the address, for example yoursite.com/free/your-title/, and says Available or Already taken.
- Category. Pick one from the list. Your own categories appear here once you add them on the Categories screen. To add one without leaving the wizard, pick + Create New Category at the bottom of the list, type a Category Name, change the Emoji Icon if you like, and click Create Category. It is added to the list and chosen for you. Cancel closes the box.
When you save, the funnel gets the address in URL Slug. If that address is already in use, a number is added to the end, for example -2.
Step 2, Upload PDF:
- Upload PDF: click Choose PDF from Media Library, upload your file or pick one, then click Use this PDF. The file name shows with a Remove button.
- External URL: paste the link in PDF URL. You see Valid PDF URL, a warning that the link does not end in .pdf (it may still work), or Invalid URL.
When you save, the add-on copies the PDF into the funnel’s own folder on your site. A link must be a direct, public link to the PDF file itself, not a share page.
Step 3, Cover Image (optional):
- Upload Image: click Choose Cover Image and pick an image. Remove Image clears it.
- External URL: paste a link in Cover Image URL. It must start with http:// or https://. A preview shows below.
The cover is the funnel’s card picture on your Showcase page and the thumbnail on My Custom Funnels. A 3D book or ebook image works well.
Step 4, Choose Template:
Click one of the 9 template cards: Gradient, Clean Card, Dark Professional, Bold Vibrant, Minimal, Modern Glass, Neon Cyber, Warm Sunset or Corporate Blue. The chosen one gets a purple border. Gradient is chosen to start with. Every template is mobile friendly and uses your accent colour.
Step 5, Customize:
- Headline (required). Filled in as “FREE: ” plus your title. The big text at the top of the squeeze page. Once you change it, your own headline is kept, also when you go Back and return to this step.
- Subheadline. The line under the headline.
- CTA Button Text (required). Starts as “Get Free Access”.
- Popup Headline. The text above the email box in the opt-in popup. Starts as “Get Your FREE [your title] (Enter Email)”.
- Accent Color. The main colour of the page.
- Affiliate Link (optional). Used for the Check Out This Resource button on the download page. Leave it blank to use the Default Affiliate Link from the main plugin’s Settings. If neither is set, that box is left off the page.
- Gradient Start Color and Gradient End Color. These only show when you picked the Gradient template.
Step 6, Preview & Save:
- Click Generate Preview. Your squeeze page appears in the box.
- Use the Squeeze Page and Download Page buttons to switch between the two pages.
- Click Save Funnel.
You see “Funnel created successfully!” with the funnel’s link, the exact address it was saved under, plus Create Another and View Funnels buttons. The preview shows the Check Out This Resource box only when you typed an Affiliate Link in Step 5. The live page also uses your Settings default.
Editing a funnel later:
Click Edit next to the funnel on My Custom Funnels. The wizard opens as Edit Funnel with everything filled in. Change what you like, then click Update Funnel on Step 6.
- The web address stays the same, so links you have already shared keep working.
- Step 2 and Step 3 keep the funnel’s current PDF and cover image. Leave them as they are, or choose a new PDF or image to replace them.
- The Created date on My Custom Funnels stays the day you first built the funnel.
Funnel Builder: Importing Funnels From a CSV File
Open it from Free List Building > CSV Import, or click Import CSV on My Custom Funnels. Each row in your file becomes one funnel.
- Click Download Sample to get funnel-import-sample.csv. It has the right column names and two example rows. Click CSV Format Reference to open the column list on screen.
- Fill in one row per funnel in Google Sheets or Excel and save it as a .csv file.
- Click Choose CSV File and pick your file. Its name and size show with a Remove button.
- Click Upload & Validate. Nothing is created yet. The add-on checks every row.
- Under Review & Import you see how many rows are valid and how many errors there are. Each error names its row, for example “Row 3: Headline is empty.” Row numbers match your spreadsheet, with the header as row 1.
- If your file uses categories you do not have yet, you see New categories detected in this CSV. Click Create These Categories & Continue. They are created and the file is checked again.
- Click Import [number] Valid Rows. Rows with errors are left out. The rows go in a few at a time, and the progress bar shows how many are done.
- When it finishes you see Import Complete with how many funnels were created, how many were skipped because they already exist, and any that failed. Each skipped or failed row is listed with its spreadsheet row number and the reason. Click View All Funnels or Import Another CSV.
Good to know:
- Each PDF and cover image is downloaded to your site during the import, so big files take a while.
- Importing the same file again is safe. A row whose funnel already exists (same title in the same category) is skipped and listed as “already exists”, so you never get -2 copies.
- If an import stops part way, the funnels already saved stay. Upload the same file again and import: the saved rows are skipped and the rest are added.
- Files saved from Excel as “CSV UTF-8” work, as do plain CSV files and Google Sheets downloads.
- A checked file is kept for one hour. After that, click Upload & Validate again before you import.
Funnel Builder: CSV Columns and an Example Row
The first row must be these column names. Column order does not matter. Extra columns are ignored.
Required columns:
- title: the funnel title. The web address is made from it.
- category: the category slug or name, in any letter case, for example email, Email or Email Marketing. The slugs and names are on the Categories screen. A new name, like Pet Care, can be created for you during the import.
- headline: the squeeze page headline.
- cta_text: the button text.
- pdf_url: a direct link to the PDF. It is downloaded to your site during the import.
Optional columns:
- subheadline: the line under the headline.
- cover_image_url: a link to the cover image. It is downloaded to your Media Library and used as the cover.
- accent_color: a hex colour with the # sign, for example #667eea. Blank uses #667eea.
- affiliate_link: this funnel’s own Check Out This Resource link. Blank uses your Settings default.
- template: one of gradient, clean-card, bold-vibrant, minimal, dark-professional, modern-glass, neon-cyber, warm-sunset, corporate-blue. Blank uses gradient.
There are no CSV columns for the popup headline or the gradient colours. Imported funnels use the headline in the popup and the standard purple and blue gradient.
Header row:
title,category,headline,cta_text,pdf_url,subheadline,cover_image_url,accent_color,affiliate_link,template
Example row:
“Healthy Habits Starter Guide”,productivity,”FREE: Healthy Habits Starter Guide”,”Get Free Access”,”https://example.com/wp-content/uploads/healthy-habits.pdf”,”Small daily changes that add up”,”https://example.com/wp-content/uploads/healthy-habits-cover.png”,”#10b981″,””,”clean-card”
Put quotes around any value that has a comma in it. Save the file with commas, not semicolons. In Excel, “CSV UTF-8” and “CSV (Comma delimited)” both work. Google Sheets users can use File > Download > Comma Separated Values.
Funnel Builder: Managing Categories
Open it from Free List Building > Categories. Categories group your funnels on the Showcase page and in the wizard.
Add a new category:
- Type a Label (required), for example Real Estate.
- The Slug fills in by itself (real-estate). Lowercase letters, numbers and hyphens only. In a CSV you can use the slug or the label in the category column.
- Paste an Emoji if you want one.
- Pick a Badge Color.
- Click Add Category.
The All Categories table:
The table lists the 12 built-in categories and your own. Columns are Emoji, Label, Slug, Badge Color, Funnels (how many switched-on funnels use it), Type (Built-in or Custom), Public URL and Actions.
- Change the emoji or colour right in the row. A Save button appears. Click it.
- Your own categories have Edit and Delete. Edit loads the category into the form at the top. Click Update Category, or Cancel Edit. The slug cannot be changed once a category exists. Delete opens a box called “Delete Category?”. Click Delete to remove it.
- Built-in categories cannot be deleted. Their Reset button puts back the original emoji and colour.
- The Public URL is that category’s page on your Showcase site, for example yoursite.com/free-resources/category/real-estate/.
A category that any funnel uses cannot be deleted.
Duplicate Custom Categories Detected:
This box means one of your own categories has the same slug as a built-in one. Click Remove Duplicate. Funnels in it keep working through the built-in category.
Funnel Builder: Your Built-in Funnels and Where Custom Funnels Appear
Your 96 built-in funnels:
Nothing about them changes. They keep their pages, settings and stats. Your custom funnels are added alongside them.
The add-on also unlocks page templates for the built-in funnels. Open any funnel’s Edit page, go to Customization, and use Squeeze & Download Page Template. Pick a template, click Preview to see it with that funnel’s own text, then save. Restore Default goes back to the original design.
Emoji and colour changes on built-in categories only change how they look on the Showcase page.
Where custom funnels appear:
- Squeeze page: yoursite.com/free/your-funnel/ (or your own URL Prefix from Settings).
- Download page: yoursite.com/free/your-funnel/download.html. Visitors land here after they opt in.
- Legal pages: privacy.html, terms.html and disclaimer.html in the same place, linked in the footer.
- The Funnels tab in the main plugin, with the built-in funnels, its on/off switch and its Edit page.
- The Showcase page, in its category, with its cover image.
- Files: wp-content/uploads/listbuilderpro-assets/funnels/your-funnel/ on your server.
Funnel Builder: Tips
- Add your categories on the Categories screen before you start the wizard, or use + Create New Category in Step 1.
- Choose the web address with care in the URL Slug box. It stays the same when you edit the funnel later.
- For the PDF, the easiest route is to upload it with Upload PDF. If you use a link, open it in a private browser window first. It should show or download the PDF straight away, with no sign-in or share page.
- Importing the same CSV again is safe: rows already imported are skipped. If a big import stops part way, simply import the same file again.
- To change the text, PDF, cover, template or colours of a custom funnel, click Edit on My Custom Funnels. Its autoresponder and per-funnel links are under Settings.
- Set a Default Affiliate Link in Settings so every custom funnel’s download page shows your Check Out This Resource button.
Funnel Builder: Troubleshooting
Notice: “FLBW Funnel Builder requires the Free List Building Website plugin”:
Install and activate the main plugin, then reload the page.
The Funnel Builder menu items are missing, or the tab says UPGRADE:
The add-on is not active. Go to Plugins and activate FLBW Funnel Builder. Diagnostics shows “FLBW Funnel Builder Addon: Not installed” until you do. The same fix applies when a funnel’s Edit page says “Install the FLBW Funnel Builder addon to unlock 9 alternate templates”.
My custom funnel shows 404:
- Diagnostics shows “Permalinks: Plain”. Go to Settings > Permalinks, choose Post name and click Save Changes.
- The funnel is switched off. Its Status says Disabled. Switch it on in the Funnels tab.
- Still 404? Go to Settings > Permalinks and click Save Changes once more, even if Post name is already chosen.
Saving says “Could not create funnel directory.”:
WordPress cannot write to your uploads folder. On the Diagnostics tab, look at “uploads/listbuilderpro-assets/” under Critical Plugin Files. If it says Missing or Not writable, ask your host to make wp-content/uploads writable.
Saving says “PDF download failed” or “PDF download returned HTTP 403”:
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 instead. The same goes for “Cover image download failed”.
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 (URL or uploaded file) is required.”:
Go back to Step 2 and choose a PDF or paste a link. When you edit a funnel, this only shows if the funnel has no PDF on file yet.
Any screen says “Security check failed.”:
The page was open a long time. Reload it and try again.
CSV says “Only CSV files are accepted.”:
Save the file as .csv, not .xlsx or .numbers.
CSV says “Missing required columns”:
Row 1 of the file must be the header row, with title, category, headline, cta_text and pdf_url spelled exactly like that. Files must use commas, not semicolons.
CSV says “CSV file is empty or has no headers.”:
The file has nothing in it. Check you picked the right file and that it was saved.
CSV row errors:
Fix the row in your file and click Upload & Validate again.
- “Title is empty.”, “Category is empty.”, “Headline is empty.”, “CTA text is empty.”, “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.
- “Template … is not valid.”: use one of the 9 template names exactly as listed.
CSV says “No validated CSV data found”:
A checked file is kept for one hour and is used up by an import. Click Upload & Validate again, then import.
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. On Diagnostics, “Default Autoresponder: Not set” or “Default List ID: Not set” means no default is chosen yet.
Diagnostics lists a caching plugin under Detected Potential Conflicts:
Exclude your funnel addresses (/free/ by default) from that plugin’s cache, as the Diagnostics note says.
Diagnostics warns “Recommend 60s+ for asset downloads”:
Your Max Execution Time is short. Large CSV imports and PDF links may stop part way. Ask your host to raise it, or import in smaller batches.
A category cannot be deleted:
“This category is in use by one or more funnels and cannot be deleted.” means a funnel still uses it. Delete the funnels in that category first. The Funnels column only counts switched-on funnels, so a switched-off funnel can also be using it.
A CSV category shows under “New categories detected” but I meant an existing one:
The category column takes a slug (email) or a name (Email Marketing), in any letter case. A name that matches neither, for example because of a typo, is treated as a new category. Fix it in your file and click Upload & Validate again, instead of creating it.
My funnel’s card has no picture on the Showcase page:
No cover image was added. Click Edit next to the funnel on My Custom Funnels, add a cover in Step 3 and click Update Funnel.