Use this page when a WPsigner recipe does not appear, does not fire, or fails in Automator → Logs. For core WPsigner mail/PDF issues, see Support → Troubleshooting.
| Symptom | Likely cause | Fix |
|---|
| No WPsigner card in the recipe builder | Addon, Automator, or WPsigner inactive | Activate all three on the same site |
| Admin error notice | Dependency missing | Install Uncanny Automator and WPsigner |
| Integration vanished after Automator update | Framework class missing | Update Automator so \Uncanny_Automator\Integration exists |
| Conditions missing | Automator Pro not active | Conditions need Pro; triggers/actions work on free |
| Symptom | Likely cause | Fix |
|---|
| Nothing in logs | Recipe still draft | Publish the recipe |
| Nothing in logs | Wrong recipe type | Use Everyone for guest signers; logged-in only for A WordPress user signs |
| Fires for other templates only | Template filter | Set Any template, or create the document from the selected template |
| User-signed never fires | Guest email | Signer email must match a WP user |
| Cloud trigger silent | Storage not connected | Configure Drive / Dropbox / OneDrive / S3 in WPsigner first |
| Payment trigger silent | No Stripe metadata | PaymentIntent must include document_id from WPsigner Stripe |
Template matching needs wps_document_created_from_template (WPsigner 3.x+) or a create action from this addon. Older documents may only match Any template.
| Log / error | Fix |
|---|
| The Automator recipe is not published | Publish the recipe |
| WPsigner is not available | Activate WPsigner |
| Template not found | Pick a template that still exists |
| This template requires a signer for slot N | Fill that signer email; check the AJAX hint |
| Provide at least one valid signer email | Signer 1 empty and “use recipe user” is No, or user has no email |
| Hourly document-creation limit reached | Wait, or raise the cap in Settings |
| Please wait a few seconds before sending again | 20s cooldown on send/remind |
| This document can no longer be sent / cancelled | Terminal status (completed, declined, expired, cancelled, trash) |
| Could not attach the tag | Document already has five tags |
| Expiration cannot be more than five years | Use a nearer date; empty field clears expiration |
| Symptom | Fix |
|---|
| Fields blank after create | Mapping names ≠ prefill keys. Align with Form Fields |
| JSON ignored | Invalid JSON — use key=value lines instead |
| Tokens not replaced | Put Automator tokens in the prefill field; they parse before WPsigner |
| Signature field empty | Expected — signature types are never prefilled |
| Token | Why it is empty | Fix |
|---|
| Signing URL | Settings off, or signer already signed/declined | Enable URLs; use a viewed/sent trigger |
| Secure download URL | Not signed/completed yet | Wait for complete, or use a signed trigger |
FIELD_* | Trigger set to Any template, or field values disabled | Select the template; enable field tokens |
| Template ID | Document not created from a known template | Create from a template (UI or action) |
| Cloud URL | No public https link stored | Use provider’s share settings; never a disk path |
| Signer WP user ID | Email is not a WP account | Expected for guests |
| Symptom | Fix |
|---|
| Channel not enabled or configured | Open WPsigner → Integrations for WhatsApp / Twilio / Slack / Telegram / Teams |
| Reminder not sent (WhatsApp/SMS) | Add a valid phone on the signer |
| Telegram silent | Signer has no chat ID WPsigner can resolve |
| Slack message empty | Provide text; HTML is stripped |
| Channel reminder on draft | Send the document first (sent / viewed) |
| Symptom | Fix |
|---|
| No Token loop / no WPsigner signers token | Automator Pro + Automator 5.10+ loopable tokens |
| Loop runs zero times | No signers, or pending filter with everyone already signed |
| Same signer repeated | Inside the loop, bind channel reminder to the loop signer email token |
If Required signers for this template stays on the placeholder, the recipe still works: fill slots 1–5 manually. Confirm you are logged in as a user who can edit Automator recipes. Endpoint: wpsua_get_template_meta.