Skip to content

Elementor Forms

Overview

Section titled “Overview”

The Elementor Forms integration lets you automatically create WPsigner documents whenever a user submits an Elementor Pro form. Each submission can generate a pre-filled document and optionally send it for signing immediately.

Requirements

Section titled “Requirements”
RequirementVersion
WPsigner1.5.0+
Elementor Pro3.0+
WordPress5.8+
PHP7.4+

Setup

Section titled “Setup”

1. Navigate to Integration Settings

Section titled “1. Navigate to Integration Settings”

Go to WPsigner → Integrations and click Configure on the Elementor Forms card.

2. Create a Feed

Section titled “2. Create a Feed”

Click New Feed to open the feed editor:

FieldDescription
Feed NameA descriptive name (e.g. “Contact NDA”)
Elementor FormSelect from discovered forms on your site
WPsigner TemplateThe template to use for document generation
Document TitleSupports {{signer_name}}, {{signer_email}}, {{date}}
Primary SignerMap Name and Email fields from the form
Variable MappingMap form fields to template variables
Auto-sendSend signing email immediately after creation

3. Map Fields

Section titled “3. Map Fields”

After selecting a form, its fields will load automatically. Map the Name and Email fields to identify the signer.

Use Variable Mapping to fill template variables with form data. For example:

  • custom.company → Company field
  • custom.phone → Phone field

4. Enable and Save

Section titled “4. Enable and Save”

Toggle “Feed enabled” and click Save Feed. The feed will process all future submissions of the selected form.

How It Works

Section titled “How It Works”
User submits Elementor form
        ↓
WPsigner checks for matching feeds (by form_id)
        ↓
Creates document from template with mapped fields
        ↓
(Optional) Sends signing email to signer
  1. When a form is submitted, the elementor_pro/forms/new_record hook fires.
  2. WPsigner checks if any enabled feeds match the submitted form’s ID.
  3. For each matching feed, it extracts signer name/email from the configured fields.
  4. A new document is created from the selected template, with form fields mapped to template variables.
  5. If auto-send is enabled, a signing request email is dispatched.

Form Discovery

Section titled “Form Discovery”

WPsigner automatically scans all published pages and posts that use Elementor to discover forms. Each form is identified by its widget ID and the page/post title where it appears.

Security

Section titled “Security”
FeatureImplementation
AuthenticationNonce verification + manage_options capability on every AJAX handler
Input Validationsanitize_text_field, absint, regex for variable names
Email Validationsanitize_email + is_email double check
Rate Limiting10 documents/minute per form via WordPress transients
Duplicate PreventionSHA-256 submission hash stored in transients for 1 hour
Error LoggingPII-redacted logging when WP_DEBUG is enabled

Multiple Feeds

Section titled “Multiple Feeds”

You can create multiple feeds for the same form — for example, to generate different documents for different templates. Each feed operates independently with its own field mappings and auto-send settings.

Troubleshooting

Section titled “Troubleshooting”

No forms appear in the dropdown

Section titled “No forms appear in the dropdown”
  • Ensure Elementor Pro is installed and activated.
  • Check that you have at least one published page with an Elementor Form widget.
  • Forms on draft or private pages are not discovered.

Document not created on submission

Section titled “Document not created on submission”
  • Verify the feed is enabled.
  • Check that the form ID matches (edit the feed to confirm).
  • Look in WPsigner → Audit for error logs.
  • Ensure the template still exists (deleted templates cause feed failures).

Signer doesn’t receive email

Section titled “Signer doesn’t receive email”
  • Confirm Auto-send is checked in the feed settings.
  • Verify the mapped email field contains a valid email address.
  • Check your WordPress email configuration (SMTP plugin, mail logs).

Technical Reference

Section titled “Technical Reference”

Hooks Used

Section titled “Hooks Used”
HookPurpose
elementor_pro/forms/new_recordProcesses form submissions

Option Keys

Section titled “Option Keys”
OptionDescription
wps_elementorforms_feedsStores all feed configurations (JSON)

AJAX Actions

Section titled “AJAX Actions”
ActionPurpose
wps_ef_get_form_fieldsRetrieve fields for a specific form
wps_ef_save_feedSave a feed configuration
wps_ef_get_feedGet a single feed by ID
wps_ef_delete_feedDelete a feed
wps_ef_toggle_feedEnable/disable a feed

Use Cases

Section titled “Use Cases”
ScenarioSetup
Landing page NDAElementor landing page form → NDA template → Auto-send
Service quoteQuote request form → Service agreement template
Event registrationRegistration form → Waiver template → Auto-send
Client onboardingOnboarding form → Client contract template → Auto-send
Freelancer proposalsProject brief form → Proposal/contract template
Rental agreementsBooking form → Rental agreement template → Auto-send
Employee agreementsHR form → Employment contract template
Consent collectionConsent form → Consent document template → Auto-send

Compatibility

Section titled “Compatibility”
ComponentSupported Versions
Elementor Pro3.0+ (required for Forms widget)
WPsigner1.5.0+
WordPress5.8+
PHP7.4+

Next Steps

Section titled “Next Steps”