Documentation/Publish content
Pro

Forms & submissions

Collect contributions, review proposed changes and understand uploads.

On this page

Set up a contribution form

  1. Open Publish → Submission forms → Set up a form. Choose the field group, draft content type and who can submit.
  2. Configure the supported fields and reviewer access. Set Form status to Accept submissions and save.
  3. Put the generated [customfields_submission form="your-form-key"] shortcode on a page. Test with fictional content.
  4. Use Review inbox to inspect entries. Approval of a new entry creates a WordPress draft for your publishing review.

Review submissions and proposed changes

Configure a public or signed-in form with up to five named steps. Supported fields include scalar and choice values, rich text, groups, repeaters, flexible layouts, conditions, safe references and private uploads. Use the form’s shortcode on a page. Entries stay in a private queue; approval of a new entry creates a draft.

A separate change-request mode targets explicitly configured existing records and requires the original content, values and schema to remain unchanged at approval. Assign reviewers explicitly: the reviewer capability does not override WordPress content permissions. Reviews show labelled nested rows and accessible reference names. Signed-in contributors can follow their status and revise returned entries; anonymous correction access is not included.

Forms allow up to 30 top-level fields, 200 definitions, three container levels and 500 submitted values. Public reference choices include up to 100 published, password-free posts or public terms. User fields select only the signed-in submitter. Reciprocal relationships use the authenticated editor. Change requests with repeated rows containing conditional descendants are refused because new rows cannot safely be matched to hidden existing values.

Private uploads before approval

Upload fields accept JPEG, PNG and WebP; file fields also accept PDF. Limits are four files, 2 MiB per file and 4 MiB in total, with a 32 MiB private inbox and a 24-megapixel image limit. PHP fileinfo is required; hosting limits may be lower.

Approval makes uploaded files public.

Before approval, files remain private and only permitted reviewers can download them through protected links. Approval requires WordPress upload permission and publishes the verified originals to the Media Library, where their URLs are public even when the post is a draft. No resized image variants are generated.

Rejection removes the private file bytes; corrections retain only explicitly kept files. File validation is not malware scanning. JavaScript is needed to add or remove repeated rows; displayed rows can be completed without it.

Notifications are off until an administrator configures recipients and enables them. Choices and recipients are checked again at mail handoff; delivery depends on the site’s mail service. An uncertain attempt is not automatically retried.

Signed-in edit and create forms

[customfields_form group="group_key" post_id="123"]
[customfields_form group="group_key" mode="create" post_type="post"]

These edit/create forms require a logged-in authorized editor. Creation makes an owned draft for review in WordPress. They do not include anonymous editing, payment or email actions. For public contributions, use the separate Pro submission queue.