Support
Log in Sign up

Troubleshooting

  • A flow did not fire. Check that it is active, then check Runs — a run that exists but failed is a different problem from no run at all. Scheduled work depends on wp-cron, which needs traffic.
  • A step keeps failing. Open the run and read the step’s error. After three attempts the run goes to the Failed view, where the step, the error and a masked payload preview are shown and “Retry from failed step” starts a new run at that step.
  • “Retry” is refused with “the flow has changed”. That is deliberate: the saved step list was rebuilt after the failure, so the recorded position no longer points at the same step. Re-run the flow from the top, or restore the version the run executed from Flow history first.
  • An approval e-mail never arrived. The run is not lost. It wakes at its own expiry and reads the ledger; if nobody has answered by then, on_timeout decides (rejection by default). Check the site’s mail delivery, and note that the links stop working once the request has expired or has already been answered.
  • The same approval link was clicked twice. Only the first click counts — the decision UPDATE is conditional on the row still being undecided.
  • A parameter shows as a JSON box instead of a form. The builder found something it could not draw without risking data: a key not in the schema, a nested condition group, or an OR group on a site without the Pro add-on. The panel says which; edit the JSON and the rest of the form is unaffected.
  • A recipe has no Import button. Its reason is printed on the card: either a step comes from the Pro add-on that is not installed, or the neighbouring plugin the trigger belongs to is not active.
  • A webhook ran twice. It should not: deliveries are de-duplicated on an event hash. If the sender changes the payload between retries the hash changes too — ask them to send a stable idempotency key.
  • A condition never matches. Operators have names (greater_than, not >), and an unknown operator never matches by design.
  • “Draft the flow” says it will spend credits. It will — 3 of them. The recipe library next door costs nothing.
Forge AI Assistant Online

Hi! I'm the Flow Forge AI assistant. Ask me anything about the plugin — setup, features, troubleshooting, or development.

Just now
Powered by Forge AI · Browse docs