WordPress

Connect your WordPress forms to Octanist for seamless offline conversion tracking. Automatically capture form submissions from popular form plugins and send them to your Octanist account.

The Octanist WordPress plugin connects your website forms directly to the Octanist platform, enabling automatic offline conversion tracking. It captures form submissions from popular form plugins, and with the help of our field mapping, maps field data according to your settings, and sends it to your Octanist account for comprehensive marketing attribution.

Field tracking can be complex depending on your form setup and field naming conventions. Our support team is ready to help you configure field mappings correctly. Contact us at [e-mail] for assistance.

Compatibility

Here is the list of supported form plugins, we are continuously adding more to the list. If you don’t see your form plugin here, please contact us at [e-mail].

Wordpress form plugin	Supported without captcha	Supported with captcha	Easy field mapping
Contact form 7	✅	✅	✅
Fluent forms	✅	✅	✅
Clio form	✅	✅	✅
WP forms	✅	✅	❌
Formidable forms	✅	✅	❌
Forminator	✅	✅	❌
Elementor forms	✅	❌	✅
Ninja forms	❌	❌	❌
Gravity forms	❌	❌	❌

For unsupported forms, you can enable tracking by adding the CSS class octanist-form to your <form> element.

Installation

Install the plugin

1. In your WordPress dashboard, navigate to Plugins > Add New
2. In the search bar, type “Octanist” and press Enter
3. Find the Octanist plugin in the search results and click Install Now
4. Once installation is complete, click Activate

Get Octanist ID

1. In your Octanist account dashboard, navigate to Integrations > Incoming
2. Under Incoming, select WordPress
3. Copy the Octanist ID

Initial Configuration

1. Once activated, go to Settings > Octanist in your WordPress dashboard
2. Enter your Octanist ID (that you copied in the previous step)
3. Click Save Changes

The plugin is now active, but you’ll need to configure field mappings for proper data collection.

Field Mappings

Field tracking can be complex depending on your form setup and field naming conventions. Our support team is ready to help you configure field mappings correctly. Contact us at [e-mail] for assistance.

Understanding Field Mapping

Different form plugins use different technical names for their fields. For example, a “Full Name” field might be named your-name, full_name, or text-123 in the code. Field mapping tells the Octanist plugin which of your form’s field names correspond to standard data fields in Octanist.

Configuration Steps

In the Field Mappings section of the plugin settings:

1. Name Field: Enter the exact name attribute of fields containing user names
2. Email Field: Enter the field name for email addresses
3. Phone Field: Enter the field name for phone numbers
4. Custom Field: Map any additional fields you want to capture

Click + Add Field to map multiple field names to the same data type. This is useful when you have different forms using different field names for the same purpose.

Finding Field Names

The most reliable way to find field names is using your browser’s developer tools:

1. Open the page with your form in a new browser tab
2. Right-click directly on the form field you want to map
3. Select Inspect from the context menu
4. Look for the name attribute in the highlighted HTML code, the code code look something like this:
5. Copy the value inside the quotes (e.g., name="your-name" → use your-name)

Example HTML:

<input
  type="text"
  name="your-name"
  value=""
  size="40"
  class="wpcf7-form-control"
  placeholder="Your Name"
/>

You would use your-name in your field mapping.

This can be a complex process. Contact us at [e-mail] for assistance. We would be happy to help you configure field mappings correctly.

Handling Multiple Fields

Combining First and Last Name:

• Form has fields: first-name and last-name
• In Name Fields mapping: Add both first-name and last-name
• Plugin automatically combines them when forms are submitted

Different Forms with Different Names:

• Contact form uses: contact-name
• Quote form uses: quote-name
• In Name Fields mapping: Add both field names
• Plugin treats both as “Name” data

Advanced Settings

Data Transmission Options

• Send data to Octanist: Master switch to enable/disable data sending to Octanist API
• Send data to (GTM) Datalayer: Push form data to Google Tag Manager’s dataLayer

When GTM integration is enabled, data is pushed with this structure:

{
  "event": "submit_lead_form",
  "user_data": {
    "email": "[e-mail]",
    "phone_number": "[phone]",
    "company_name": "John Doe",
    "custom": "Custom field data"
  }
}

Debug Mode

Enable Debug Mode to print diagnostic information to your browser’s developer console. This helps troubleshoot tracking issues but should only be enabled when necessary.

Testing & Validation

1. Fill out and submit a test form on your website
2. Check your Octanist dashboard for the new lead data
3. If using Debug Mode, check browser console for “Octanist Debug” messages
4. Verify field mappings are working correctly

Troubleshooting

Forms Not Being Tracked

Check Plugin Status

• Verify the Octanist ID is entered correctly
• Ensure “Send data to Octanist” is enabled
• Confirm the plugin is activated

Verify Form Plugin Support

• Check if your form plugin is in the compatibility table
• For unsupported forms, add octanist-form CSS class to the <form> element
• Enable Debug Mode to see console messages

Field Mapping Issues

• Field names must match exactly (case-sensitive)
• Use browser inspection to verify field names
• Check for typos in field mapping configuration

Data Appears Incorrect

• Combined fields: Multiple fields mapped to the same type are separated by a pipe (|) symbol
• Missing data: Verify all required fields are properly mapped
• Wrong values: Double-check field name mapping using browser inspection

If you’re experiencing persistent issues with field mapping or data collection, don’t hesitate to contact our support team at [e-mail]. We’re here to help you get your tracking set up correctly.

Next Steps

Your WordPress integration is now active! To complete your conversion tracking setup:

1. Test thoroughly: Submit several test forms to verify data collection
2. Set up outgoing integrations: Connect Octanist to your advertising platforms
3. Monitor data flow: Check your Octanist dashboard regularly for incoming leads

For setting up outgoing integrations, refer to our Outgoing Integrations documentation.