Set up WCKD Forms Lite

WCKD Forms Lite is the small package for other sites. It renders forms on that site, then posts submissions to your main WCKD Forms dashboard. Lite does not have a dashboard, database, inbox, mailer, webhooks, or PHPMailer. The main dashboard validates, stores, emails, dispatches webhooks, and manages the lead.

Use Lite when a site should collect leads but you want one central WCKD Forms inbox.

The main dashboard must allow posts from Lite sites.

  1. Sign in to the main WCKD Forms dashboard.
  2. Open Settings → Operations → Lite forms.
  3. Enable Allow WCKD Forms Lite (other sites) to POST to this install's intake API.
  4. Copy the routed public Intake URL and Ingest key. You will paste both into the Lite installer.
  1. Upload the Lite package folder to the other site.
  2. Make sure PHP can write to that folder during setup. The installer writes a generated private config file.
  3. Open the Lite setup URL in the browser.
  4. Paste the main dashboard Intake URL and Ingest key.
  5. Set the success, error, and rate-limit redirect URLs for this Lite site.
  6. Save, then protect or delete the setup file on production.

Note. The generated private config file should not be committed or reused across unrelated sites.

Lite forms post to /form-submit. On the Lite site, that public route must point to Lite. Use the rewrite example included with your Lite package and adjust it for your install location.

  1. Put the rule in the Lite site's root rewrite config, above WordPress or other CMS catch-all rules.
  2. If your Lite install lives somewhere else, adjust only the internal rewrite target.
  3. Do not point the Lite site's /form-submit rule at the full dashboard package unless the full package is installed on that same site.

Use the embed snippets from Settings → Forms → Other Sites. Add the first snippet once per page, then place the form snippet where the form should appear. The dashboard-generated snippet is safer than hand-copying a server path because it reflects your install.

<?php wckd_form('default', 'Contact page'); ?>

The first argument is the form key. The second argument is the placement label shown in the dashboard inbox and performance views.

Lite renders fields locally, but the main dashboard validates the submission. The Lite schema must match the dashboard schema for the same form key.

  1. Create or edit the form in the main dashboard.
  2. Copy that form's schema definition from the full install.
  3. Add it to the Lite site's schema definitions using the same form key.
  4. Add the form key to the Lite form map.

Then embed it:

<?php wckd_form('event-inquiry', 'Event inquiry page'); ?>

Do not copy the full dashboard registry into Lite. The full registry contains dashboard settings Lite does not need.

  1. Embed wckd_form('default', 'Lite test');.
  2. Load the page in a real browser, wait a few seconds, type or interact with the page, and submit.
  3. Expect the success redirect and a new lead in the main dashboard.
  4. If it redirects to the error URL with ?wckd=, copy that code and check Troubleshooting.
  • 404 on submit: the Lite site's /form-submit rewrite is missing or points at the wrong folder.
  • NO_SCHEMA: the form key is not registered in the Lite form map or the matching schema definition is missing.
  • VALIDATION_FAILED: the Lite schema does not match the dashboard schema for that form key.
  • INGEST_UNAUTHORIZED: the Lite ingest key does not match the main dashboard's key.
  • SATELLITE_INTAKE_DISABLED: Lite intake is off in the main dashboard Operations settings.
  • INTAKE_CURL_MISSING: PHP cURL is not enabled on the Lite site.