This module allows Webform routes to be handled cleanly in hybrid headless setups by extending the JSON:API resolver. It enables frontends to redirect or proxy to Drupal for rendering and submission, while respecting route access and treating restricted forms as "not found."
jsonapi_frontend_webform is an optional addon for jsonapi_frontend. Drupal Webforms are interactive routes (not JSON:API content entities), so this addon teaches the resolver how to handle Webform pages cleanly in hybrid headless setups.
Features
- Extends
/jsonapi/resolveso Webform routes (including aliased paths like/contact→/form/contact) resolve as non-headless. - Returns
drupal_urlso frontends can redirect/proxy to Drupal for rendering + submission (no iframes required). - Respects route access and treats restricted forms as “not found”.
Post-Installation
- Enable webform, jsonapi_frontend, then enable jsonapi_frontend_webform.
- Configure jsonapi_frontend at
/admin/config/services/jsonapi-frontend(especially your Drupal URL/
origin and proxy secret if using frontend-first). - Ensure your frontend routing/proxy forwards Webform routes (typically
/form/*) to Drupal in Split routing or Frontend-
first mode.
Additional Requirements
Recommended modules/libraries
- If you attempt fully headless form rendering/submission (advanced), you may evaluate webform_rest and a frontend renderer library. This addon itself is hybrid-first and does not require them.
Similar projects
- next_webform / nextjs-drupal-webform: aims at fully headless Webform rendering (Next.js-specific). jsonapi_frontend_webform focuses on the
simpler, cross-framework hybrid approach (proxy/redirect to Drupal).
Supporting this Module
- Issue queue: https://www.drupal.org/project/issues/jsonapi_frontend
- GitHub source: https://github.com/code-wheel/jsonapi-frontend-webform
Ask your assistant about JSON:API Frontend Webform
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.