Gravity Flow integration is optional and requires Premium or Agency. When Gravity Flow is active, the plugin registers AI Text and AI Image workflow step types.
When To Use A Workflow Step #
Use a step when generation should happen at a particular point in an approval, review, or routing workflow rather than immediately after submission. Examples include generating a summary after an approval, preparing an image after content review, or drafting an internal response before a later human step.
Configure A Step #
- Create and test the underlying AI Text or AI Image feed on the form.
- Open the form’s Gravity Flow workflow settings.
- Add the matching AI step type.
- Choose the feed the step should run.
- Configure the normal Gravity Flow step settings and save the workflow.
The step uses the selected feed’s provider, credential source, model, prompts, destinations, image settings, and conditional logic. Its normal Trigger Mode does not prevent explicit workflow execution.
The plugin’s Feeds tab lists both AI feed types and the AI Text and AI Image workflow steps that use them. The workflow inventory links to each step and changes the step’s native Gravity Flow active status; it does not activate or deactivate the selected AI feed for the step.
Runtime Behavior #
- The step evaluates the feed’s conditional logic against the workflow entry.
- Text outputs use the same live field adapters, typed validation, and verified persistence as submission execution.
- A text feed’s Existing Values setting applies: fill-empty omits populated destinations, while overwrite replaces configured targets.
- Images are sanitized and saved into the configured destination field.
- Provider usage is recorded in the same ledger used by other runs.
- Site-wide provider/form controls and monthly caps still apply.
- Failures are recorded and surfaced through the workflow step behavior.
For text feeds, Workflow Notifications determines whether the feed completion or failure notification event is also emitted after the workflow run. The checkbox does not create or enable the workflow step.
If Gravity Flow is not active, or the installation has only the Pro plan, these step types are not registered.
