elementor/list-form-submissions lists Elementor Pro Form widget submissions, optionally filtered by form and optionally including the field values.
Requires Elementor Pro. Without it the ability reports that plainly rather than failing obscurely.
At a glance
| Ability | elementor/list-form-submissions |
| Toolset | Elementor — toolset/elementor |
| Group | Elementor › Form Submissions |
| Requires | Elementor, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Submission metadata — when, from which form, which page — answers most operational questions: is the form working, how many came in this week, did the one from Tuesday arrive.
The field values are what people typed, and on a contact form that is names, email addresses and whatever they chose to write. That is personal data, and it leaves the site when an assistant reads it.
So values are behind a flag rather than included by default. The common question is answerable without them.
Elementor Pro stores submissions in its own tables rather than as posts, which is why this exists — nothing generic reaches them.
Submissions accumulate indefinitely unless something prunes them. A site with a busy form and no retention policy is holding years of personal data, which is worth knowing under most privacy regimes.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
form_id | string | No | Restrict to one form. |
include_values | boolean | No — defaults to false | Include the submitted field values. Personal data. |
limit | integer | No | How many to return. |
What comes back
| Name | Type | What it is |
|---|---|---|
submissions | array | Each submission, with values only when requested. |
count | integer | How many were returned. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
How many form submissions did we get this week?
It resolves to one call:
{
"ability": "elementor/list-form-submissions",
"parameters": {
"limit": 50
}
}Worth knowing
- Values are off by default because they are personal data.
- Stored in Elementor Pro’s own tables — nothing generic reaches them.
- Submissions accumulate indefinitely without a retention policy.
- Requires Elementor Pro.
Related abilities
- Get Elementor Pro Form Submission — one in detail
- Delete Elementor Pro Form Submission — remove one
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category