Skip to content

WordPress Post

Create a WordPress post (or any custom post type) from each form submission — with full taxonomy, meta, and ACF support. Ideal for front-end submissions: guest articles, listings, testimonials, event submissions, and directories.

Enable it

  1. Open your form → Settings → Integrations.
  2. Enable WordPress Post.
  3. Choose the post type and default status for created posts.
  4. Choose the author the posts are attributed to.
  5. Map form fields to the post's title, content, excerpt, and featured image.
  6. Optionally map taxonomies and custom fields (see below).
  7. Save the form.

Settings

SettingPurpose
Post typeAny registered post type. Defaults to post.
Post statusdraft, pending, publish, future, or private. Defaults to pending.
AuthorCurrent user, a Fixed author (pick a user), or Anonymous (author ID 0).
Title / Content / Excerpt / Featured imageEach maps to a form field. Content allows safe HTML; the title and excerpt are plain text.

Publish safety

If you choose Publish but the resolving author lacks permission to publish that post type, Formatrica automatically downgrades the new post to Pending rather than publishing without capability. This matters most with the Anonymous and front-end-visitor cases.

Taxonomies

Add one row per taxonomy you want to set. Each row has:

  • Taxonomy — the taxonomy slug (e.g. category, post_tag, or a custom one).
  • Field — the form field supplying the term(s). Values can be comma-separated or a multi-value field.
  • ModeNames (terms are matched by name and created if missing) or IDs (values are treated as existing term IDs).

Terms replace any existing terms for that taxonomy on the post.

Custom fields & ACF

Add one row per custom field: a meta key and the form field that supplies its value.

  • If the meta key matches an Advanced Custom Fields field, Formatrica writes it through ACF's own API (update_field) and type-casts the value to match the ACF field type — text, number, true/false, select, checkbox, relationship, image, WYSIWYG, and more.
  • Otherwise the value is written with update_post_meta (scalars are sanitized; arrays stored as-is).

How it works

  • Runs synchronously on submission, so the created post exists immediately.
  • Fires the formatrica_wp_post_created action after creation, and passes the wp_insert_post arguments through the formatrica_wp_post_args filter first — see the Hooks & Filters reference.

Test it

  • Submit the form and confirm a new post appears under the chosen post type with the mapped title, content, terms, and custom fields.