RescueFill Docs

Overview

RescueFill is a WordPress plugin that automatically captures partial form submissions and helps you recover abandoned leads. 68% of visitors who start your form never finish it — RescueFill captures their email the moment they type it and gives you a full suite to bring them back.

Supported Forms

• Contact Form 7
• WPForms (Lite & Pro)
• Gravity Forms
• Ninja Forms
• Elementor Forms
• Formidable Forms
• Any HTML <form> with an email field

Installation

From WordPress.org

1. Go to Plugins → Add New in your WordPress admin
2. Search for "RescueFill"
3. Click Install Now then Activate

Manual Upload

1. Download the rescuefill.zip file
2. Go to Plugins → Add New → Upload Plugin
3. Choose the zip file and click Install Now
4. Activate the plugin

Pro Addon Installation

1. Purchase a Pro licence at rescuefill.com/pricing
2. Download rescuefill-pro.zip from your account
3. Upload and activate alongside the free plugin
4. Enter your licence key when prompted

Quick Start

1. Navigate to RescueFill in your admin sidebar
2. Configure email settings under Settings → Email & Providers
3. The plugin starts tracking form submissions immediately
4. Watch leads appear in the Dashboard as visitors fill forms
5. Create an Audience List and assign leads
6. Send a Campaign to recover abandoned leads

Lead Tracking

RescueFill injects a lightweight JavaScript tracker on your pages that monitors form field changes. When a visitor types their email, the tracker sends the data to the REST API endpoint, and a lead record is created instantly.

How Detection Works

• The tracker listens for change and blur events on input[type="email"]
• When an email is detected, a periodic save runs every N seconds (configurable)
• Form data is captured progressively — the more fields they fill, the more data you get
• When the tab closes without submitting, the lead is marked abandoned after the inactivity threshold

Inactivity Threshold

The inactivity threshold (default: 30 minutes) determines how long to wait after the last activity before marking a lead as abandoned. Adjust this in Settings → General.

Dashboard

The dashboard provides a real-time overview of your lead recovery performance:

• Total Leads — all captured leads
• Abandoned — leads that left without submitting
• Recovered — leads who returned via recovery link
• Recovery Rate — percentage of abandoned leads recovered
• Lead Status Breakdown — visual counts by status
• Recent Leads — latest captured leads with status badges

Leads Management PRO

The Leads screen provides a full-featured table with filtering, search, pagination, and inline actions.

Filters

Inline Actions

• View — open lead detail modal with form data, location, and actions
• Assign to List — dropdown to assign/change list
• Delete — permanently remove a lead
• Send Reminder — send a recovery email (in detail modal)

Bulk Assign to List

Select multiple leads using the checkboxes, then click "📋 Assign to List" to bulk assign all selected leads to a list at once.

Audience Lists

Lists help you segment leads into targeted groups. Each list has a colour tag for easy identification.

Creating a List

1. Go to Lists → click "+ New List"
2. Enter a name, optional description, and pick a colour
3. Optionally add auto-assign rules (Pro)
4. Click Create List

Auto-Assign Rules PRO

With the Pro addon, you can configure location-based auto-assign rules per list. Leads matching a country code, city, or region will be automatically placed in the list.

Campaigns

Send targeted broadcast emails to your audience lists. Create campaigns with a name, subject line, body (with template tags), and select a sending provider.

Template Tags

Sending Providers

Export PRO

Export leads as CSV or JSON with custom field selection and filter conditions.

• Choose which fields to include (email, status, country, dates, etc.)
• Filter by status, list, country, date range, or form
• Set maximum record limit (up to 50,000)
• Download instantly from the browser

Settings

General

• Enable/Disable Tracking — toggle form monitoring
• Inactivity Threshold — minutes before marking as abandoned
• Save Interval — how often the tracker sends data (seconds)
• Data Retention — auto-purge recovered/submitted leads after N days

Email & Providers

• From Name / Email — sender identity
• Reply-To Email — where replies go
• Email Subject & Body — default recovery email template
• Provider Selection — SMTP, Brevo, or SendGrid
• API Keys — Brevo / SendGrid API key management

Advanced (GDPR/CCPA)

• GDPR Mode — require consent before tracking
• Track IP — enable/disable IP collection
• Track Location — enable/disable geolocation

Multi-Step Sequences PRO

Create automated drip email sequences with multiple steps that fire based on configurable delays. When a lead is marked as abandoned, they are enrolled in the active sequence automatically.

Creating a Sequence

1. Go to Sequences → click "+ New Sequence"
2. Add steps with subject, body, delay, and enable/disable toggle
3. Set trigger delay (minutes after abandonment)
4. Optionally target a specific list and provider
5. Activate the sequence

Multi-Subsequence Campaigns PRO

Enhance any broadcast campaign with follow-up subsequence steps. Each step has its own subject line, body, delay (days + hours), and conditions.

How It Works

1. Create or edit a campaign
2. Click the "🔄 Steps" button on the campaign row
3. Add follow-up steps with delay and conditions
4. Conditions include: skip recovered, only unopened, only no-click
5. Save and click "🚀 Schedule & Send All"
6. Steps are scheduled via WP Cron based on their delay settings

Funnel Builder PRO

The drag-drop funnel builder lets you create visual automation workflows with nodes for Email, Delay, Condition, List Assignment, Webhook, and more. Funnels use a directed graph (nodes + edges) executed by the server — each abandoned lead is enrolled and tracked independently via the rfpro_funnel_enrollments database table.

How Enrollment Works

1. When a lead is marked abandoned, the engine finds all active funnels
2. The lead is enrolled in each matching funnel (one enrollment record per funnel)
3. Execution starts at the Trigger node and follows edges to the next node
4. Delay nodes schedule a WP Cron event to resume after the specified time
5. Condition nodes branch via Yes/No edges based on lead field values
6. Enrollment completes when an End node or dead-end is reached

Node Types

Condition Operators

Available Condition Fields

country_code, country_name, city, region, status, email, form_id, form_name

Email Template Tags in Funnels

Built-in Templates

Two templates are available from the + New Funnel dialog:

• Welcome Sequence — 3 emails over 3 days (immediate, +1 day, +2 days)
• Abandoned Form Recovery — conditional branching: high-intent leads get a personalised email; others get a general reminder

Webhooks PRO

Configure outgoing webhooks with HMAC signatures, retry logic, and delivery logs. Connect to Zapier, Make (Integromat), n8n, or any HTTP endpoint.

Events

• lead.created — new lead starts filling a form
• lead.abandoned — lead abandons a form
• lead.recovered — lead clicks recovery link
• lead.submitted — lead completes the form
• email.sent — recovery email sent
• list.assigned — lead assigned to a list

Brevo / SendGrid PRO

Replace WordPress SMTP with professional email delivery services for better deliverability and analytics.

1. Get your API key from Brevo or SendGrid
2. Go to Settings → Email & Providers
3. Select your provider and paste the API key
4. Use Send Test to verify the connection

Location-Based Auto-Lists PRO

Automatically route leads to lists based on their geolocation. Configure rules per list or globally via the Location Rules panel.

Rule Types

A/B Testing PRO

Split-test subject lines, email copy, timing, and CTAs to optimise your recovery rates. Available on Pro and Agency plans.

REST API

All endpoints are under /wp-json/rescue/v1/ and require manage_options capability (except /track). The Pro funnel builder uses a secondary namespace /wp-json/rfpro/v1/.

Authentication

Pass the X-WP-Nonce header with a valid REST nonce obtained via wp_create_nonce('wp_rest').

Core Endpoints rescue/v1

Pro Funnel Builder Endpoints rfpro/v1

Example: Get Leads

GET /wp-json/rescue/v1/leads?status=abandoned&per_page=10&page=1
X-WP-Nonce: <nonce>

Response:
{
  "success": true,
  "data": [ ... ],
  "total": 42,
  "pages": 5
}

Hooks & Filters

Actions

Filters

Developer Example: Custom Funnel Action

// Notify Slack when a lead completes a funnel
add_action( 'rfpro_resume_funnel_enrollment', function( $enrollment_id ) {
    // enrollment completes when status=completed
    global $wpdb;
    $row = $wpdb->get_row( $wpdb->prepare(
        "SELECT * FROM {$wpdb->prefix}rfpro_funnel_enrollments WHERE id = %d",
        $enrollment_id
    ) );
    if ( $row && $row->status === 'completed' ) {
        // fire your custom notification
    }
} );

GDPR / CCPA Compliance PRO

RescueFill includes built-in GDPR/CCPA compliance features:

• GDPR Mode — requires explicit consent before tracking
• Disable IP Tracking — stop collecting IP addresses
• Disable Location Tracking — stop geolocation lookups
• Data Retention — auto-purge old leads after configurable days
• Right to Deletion — delete individual leads from the admin

License Activation PRO

The RescueFill Pro addon uses the Software License Manager (Tips & Tricks HQ) hosted at themefreex.com to validate and manage licence keys.

Activating Your Licence

1. Purchase a Pro licence at themefreex.com/rescuefill-pro
2. Check your order confirmation email — the licence key will be included
3. In your WordPress admin go to RescueFill → Licence
4. Paste your key into the Licence Key field and click Activate
5. The page will refresh with your plan (Pro / Agency), expiry date, and activated domain

Deactivating / Transferring

To move your licence to a different site, click Deactivate on the Licence page. This frees up one activation slot. You can then re-activate on the new site.

Licence Plans

Automatic Renewal Check

Once activated, RescueFill Pro checks your licence status daily via WP Cron. If the key has expired, Pro features are gracefully disabled and a notice appears in the admin — existing data and leads are never deleted.

Integrations — Zapier, Make & n8n PRO

RescueFill Pro fires real-time webhook events to any HTTP endpoint. Connect to Zapier, Make (Integromat), n8n, or build a custom integration in minutes.

Setting Up a Webhook

1. Go to RescueFill → Integrations
2. Click + New Webhook
3. Enter a name and the destination URL (your Zapier catch URL, Make webhook, n8n webhook, etc.)
4. Select one or more events to subscribe to
5. Optionally enable HMAC Signature and set a secret key for verification
6. Click Save — the webhook fires on the next matching event

Webhook Events

Webhook Payload

POST https://your-endpoint.com/webhook
Content-Type: application/json
X-RescueFill-Signature: sha256=<hmac_hex>

{
  "event": "lead.abandoned",
  "timestamp": "2026-03-30T14:22:10Z",
  "site": "https://yoursite.com",
  "lead": {
    "id": 42,
    "email": "jane@example.com",
    "name": "Jane Doe",
    "phone": "+1 555 0100",
    "status": "abandoned",
    "city": "New York",
    "country_code": "US",
    "country_name": "United States",
    "form_name": "Contact Form",
    "created_at": "2026-03-30T14:10:00Z"
  }
}

Verifying HMAC Signatures

// PHP example
$secret  = 'your-webhook-secret';
$payload = file_get_contents('php://input');
$sig     = $_SERVER['HTTP_X_RESCUEFILL_SIGNATURE'] ?? '';
$expected = 'sha256=' . hash_hmac('sha256', $payload, $secret);
if ( ! hash_equals($expected, $sig) ) {
    http_response_code(401);
    exit('Invalid signature');
}

Zapier Quick-Start

1. In Zapier, create a new Zap → Trigger: Webhooks by Zapier → Catch Hook
2. Copy the generated Zapier webhook URL
3. Paste it into RescueFill Integrations → New Webhook, subscribe to lead.abandoned
4. Click Test or abandon a test form to send a sample payload
5. Map the fields in Zapier and connect your action (HubSpot, Google Sheets, Slack, etc.)

Make (Integromat) Quick-Start

1. In Make, add a Webhooks → Custom webhook module
2. Copy the webhook URL from Make
3. Paste it into RescueFill Integrations → New Webhook
4. Send a test event — Make will auto-map the payload fields
5. Build your scenario with the lead data (CRM update, email, spreadsheet, etc.)

n8n Quick-Start

1. In n8n, add a Webhook node, set method to POST, copy the URL
2. Paste into RescueFill Integrations → New Webhook
3. Trigger a test event
4. Connect downstream nodes (HTTP Request → CRM, Email Send, etc.)

Retry Logic

Failed deliveries (non-2xx response or network timeout) are retried automatically: 3 attempts at 1-minute, 5-minute, and 30-minute intervals. Each attempt is logged in the Delivery Log tab of the Integrations screen.

WooCommerce License Mapper

The RescueFill WooCommerce Licenses companion plugin is installed on themefreex.com (the licence server site). It bridges WooCommerce orders with the Software License Manager to automate licence key delivery.

Installation (Seller Site)

1. Upload rescuefill-woo-licenses.zip to your WooCommerce site
2. Activate. A new menu item appears under WooCommerce → RescueFill Plans
3. For each WooCommerce product (or variation) you sell, set:

Automated Flow

1. Customer buys a Pro plan in your WooCommerce store
2. On order completion the plugin calls the SLM API to create a licence key
3. The licence key is appended to the WooCommerce order completion email
4. Customer activates from RescueFill → Licence on their WordPress site
5. On refund / cancellation the licence is automatically deactivated

Expiry Reminders

A daily WP Cron job sends renewal reminder emails to customers at 30, 7, and 1 day before licence expiry. Reminders are sent from your WooCommerce From Email address.

SLM API Credentials

The plugin uses hardcoded constants set to your themefreex.com SLM installation:

define( 'RFWL_SLM_URL',           'https://themefreex.com' );
define( 'RFWL_SLM_ACTIVATE_KEY',  '69b8809474b014.90397835' );
define( 'RFWL_SLM_CREATE_KEY',    '69b8809474afa9.52483643' );
define( 'RFWL_ITEM_REF',          'rescuefill-pro-398' );

Changelog

v2.2.0 — March 2026

• Fix: Pro auto-assign rules panel in Lists now correctly appears when Pro addon is active (was always showing upsell)
• Fix: Funnel builder — saved nodes and edges no longer display as 0 after create/edit (double JSON-encoding bug in REST)
• Fix: isPro flag now read synchronously at React mount — eliminates flash of upsell on first render
• New: Location auto-assign rules are now stored per list and passed through the free plugin via WordPress filter hooks (rescue_allow_list_auto_assign_rules, rescue_list_auto_assign_rules)
• New: Full integrations screen with 12 pre-built app cards (Zapier, Make, n8n, HubSpot, Salesforce, ActiveCampaign, Slack, Mailchimp, Google Sheets, Airtable, Twilio, Custom Webhook)
• New: Software License Manager (SLM) client in Pro addon — daily cron validation, REST status endpoint, graceful degradation
• New: rescuefill-woo-licenses companion plugin for automated licence key delivery on themefreex.com
• New: Funnel status validation on update (only active, paused, draft accepted)

v2.1.2 — February 2026

• ReactFlow drag-drop funnel builder UI polish
• Multi-subsequence campaign follow-up steps
• A/B testing framework scaffolding
• Improved GDPR consent mode in tracker

v2.1.0 — January 2026

• Initial public release of RescueFill Pro addon
• Funnel builder, drip sequences, webhooks, Brevo/SendGrid, location rules, export

FAQ

Does it work with Contact Form 7?

Yes! RescueFill auto-detects and integrates with all major form plugins including CF7.

Is the free version production-ready?

Absolutely. The free version includes lead capture, geolocation, lists, campaigns via SMTP, export, and full REST API.

What does the Pro addon add?

Pro adds multi-step sequences, multi-subsequence campaigns, drag-drop funnel builder, Brevo/SendGrid, webhooks with Zapier/Make, location-based auto-lists, A/B testing, and white-label (Agency).

Can I export leads to a CRM?

Yes — use Export for CSV/JSON, or connect via Webhooks (Pro) to push live data to HubSpot, Salesforce, or any endpoint.

How do recovery emails work?

Each lead gets a unique recovery token. The recovery link in emails redirects them back to the exact page with their form pre-filled.

What's the difference between Sequences and Subsequences?

Sequences are standalone automated drip flows triggered by lead abandonment. Subsequences are follow-up steps attached to a specific broadcast campaign — they let you add multi-step follow-ups to any one-off campaign.