Skip to content
NotionApps Docs

Form submit redirection (and other submit actions)

Canonical page for form on_submit actions. Button click actions stay on Button component.

What this is / when to use it

Section titled “What this is / when to use it”

After a Create Form or Update Form successfully writes the row, the app can run one or more in-app actions. The action type is always on_submit. The subtype is one of:

Subtype Enum What it does
Change data change_data Writes extra fields on the same row (exact or CURRENT_USER).
Go to screen go_to_screen Opens another screen (often a hidden Content “thank you” or the details page).
Redirect URL redirect_url Sends the browser to an external URL.

Use these when submit should finish the job (stamp a status, leave the form, or send the user to a portal).

When not to use them:

  • Opening a tel/mailto without saving — use a Button.
  • Starting a long workflow with many steps — also attach Workflow form_submitted. Submit actions and workflows can both run; do not assume one replaces the other. See Which automation.

Before you start

Section titled “Before you start”
  1. The form saves successfully on its own.
  2. Target screens exist if you use go_to_screen. Hide them from nav when they are thank-you pages.
  3. Fields you stamp with change_data are writable.

Build it

Section titled “Build it”
  1. Open the form screen.
  2. Open Submit actions / Automated actions on save (same feature; old docs said “automated actions on save”).
  3. Add on_submit.
  4. Choose change_data, go_to_screen, or redirect_url.
  5. For change_data, pick the field and EXACT or DYNAMIC (CURRENT_USER). Dates also have DATE / TIME / DATE_TIME.
  6. For go_to_screen, pick the target screen id.
  7. For redirect_url, enter a full https URL.
  8. Publish. Submit a test row. Confirm the stamp, the next screen, or the external page.

Every control

Section titled “Every control”
Control Options What it does
Action type on_submit Only fires after a successful save.
Subtype change_data / go_to_screen / redirect_url See table above.
Field + value Exact / current user Extra writes.
Target screen Screen id In-app navigation.
URL String External redirect.
Submit label 1–50 characters The save button text, not the action.
Success message Optional title Stays the popup title. The save-state line is separate.

Desktop submit placement (sticky footer vs inline) is a layout how-to: Control Desktop Form Submit Placement.

What users see

Section titled “What users see”

They tap Submit. Validation runs first (required, email/phone). If the local save succeeds, submit actions run, and the popup keeps your custom success title. The detail line is the save state:

State Meaning
Saved in NotionApps We accepted the row. Notion does not have a page yet.
Sending to Notion The write is in flight or retrying.
Confirmed in Notion The Notion page exists.
Needs attention The create was lost mid-flight. We will not open a second page.

A save is kept if Notion is rate-limiting or the job restarts. Submitting the same form again does not create a second Notion page. If save fails, submit actions do not run.

Limits and plans

Section titled “Limits and plans”
  • Submit actions are not Workflow Foundation. Legacy Databases → Automate (email/SMS/webhook) is a third system. See Which automation.
  • change_data cannot write formula/rollup.
  • Redirect to a custom domain you do not control will lose the session unless that destination is still your app.
  • Prefill and submit actions are independent.

Example

Section titled “Example”

Add lead submit:

  1. change_data Status = New (exact).
  2. change_data Owner = CURRENT_USER.
  3. go_to_screen → Content Thanks.

A workflow on form_submitted then notifies sales. The thank-you screen does not need to know that.

Fix problems

Section titled “Fix problems”
Symptom Likely cause What to do
Redirect happens but row missing Validation failed and you tested a button, not submit Use the form submit control.
Workflow and redirect race Both fired Expected. Workflow is async. Redirect can leave before the queue item appears.
Go to screen 404 Screen hidden and visibility blocks the user Fix visibility, or pick another target.
Old help URL 404 /customize-app/form-submit-redirection This page is the current path.
Needs attention stays up The Notion create was lost mid-flight The row is kept in NotionApps. Do not submit again to force a second page. Contact support if it does not clear.
Section titled “Related”

Buttons: Button component. Forms: Form (Add Item). Workflow: Trigger catalog. 14 Sep 2026 Release. Reload and sync.