Documentation

Advanced Forms for ACF

Creating a form

Creating a form is as simple as creating a new post in WordPress, then setting the form as the location for one or more field groups. This document outlines form creation via the UI. For information on creating forms via code, see Registering forms programmatically.

To create a new form

  1. Navigate to the WordPress admin and under the Forms menu, click Add New.
  2. Enter a name for the form.
  3. Optionally enter a description for the form.
  4. If you wish to show a success message after the form is submitted, enter the message in the Success message field.
  5. Click the blue Publish button to save the form.

advanced-forms-acf-form-edit-screen.jpg

Configuring a field group to render on the form

At this point, you have an empty form with no fields. To add fields to the form, you need to set the form as the location for one or more field groups.

Creating a new field group for the form

You may create ACF field groups as you normally would using the ACF > Field Groups screen. However, you can also create a new field group directly from the form edit screen using the Create field group button in the Fields metabox:

advanced-forms-acf-new-field-group-button.jpg

Connecting an existing field group to the form

Once you have a field group created, you can set it to render on the form by selecting Advanced Forms > Form in the field group's Location Rules settings and then selecting the form from the resulting list:

acf-field-group-form-location-selection.jpg

Setting fields to appear in forms only

If you are using a field group on both a form and another location in the WordPress admin, you may wish to hide some fields that are intended for the form only. To do so, you may use the Hide from admin setting added to fields in the field group edit screen:

advanced-forms-acf-hide-from-admin-setting.jpg

Spot an issue? Please let us know about it.

Good dev stuff, delivered.

Product news, tips, and other cool things we make.

We never share your data. Read our Privacy Policy

© 2016 – 2024 Hookturn Digital. All rights reserved.