Choose a language

Desktop monitor showing a structured content editing screen

ACF for WordPress: What It Does and When to Use It

Published November 5, 2026 · Mis à jour le November 16, 2026 · 14 min read

Advanced Custom Fields (ACF) is a free WordPress plugin, maintained by WP Engine, that lets you attach extra structured content to your posts, pages, users, and more, without touching the WordPress database. In one sentence: it turns the default title-and-body editor into a flexible content system by letting you define fields (text, image, date, relationship, and others) in the admin and then display them in your theme or block.

This guide answers the questions a site owner or junior developer usually asks in order: what ACF actually is, how Free and Pro differ, what field types you get, how to install it and show a field on the front end, when it's the wrong tool, and what it doesn't do on its own. You'll see the exact admin path for your first field group, a plain-English look at the F

The path in 6 steps

The steps of this page, in order.

  1. 01 Understand what ACF is A plugin that adds custom fields to WordPress content types without editing the database.
  2. 02 See real use cases Product specs, author bios, event dates, content WordPress doesn't have a slot for by default.
  3. 03 Compare Free vs Pro Decide whether you need repeaters, flexible content, and ACF Blocks.
  4. 04 Install and set up Install the plugin, create a field group, and attach it to a post type.
  5. 05 Display a field Use get_field() and the_field() in your theme to output the value.
  6. 06 Know when to skip it Recognize the cases where ACF adds overhead without benefit.

01 / 09

What is ACF in WordPress, in plain English?

ACF is a free plugin by WP Engine that lets you add named, structured content fields to WordPress items, posts, pages, users, taxonomy terms, media, comments, and options pages, and then display those values in your theme or block. For the full picture, from hosting and themes to security and SEO basics, see our WordPress guide.

Core WordPress gives every post four slots: a title, a body, an excerpt, and a featured image. A custom field is a named slot you add for anything else, a price, a start date, an author bio. ACF creates those slots through an admin interface, so you never touch SQL or register meta boxes by hand.

ACF is not a page builder and not a block library. It organizes content into fields; how that content appears on the page is still up to your theme, block, or template. Values are stored in WordPress's standard postmeta tables, so content you create today stays readable if you switch themes later.

Woman building a page layout on a laptop and a large monitor

02 / 09

What kind of content does ACF actually structure?

ACF is most useful when the same page repeats a pattern of extra facts that visitors need to find quickly.

The pattern is always the same: several small facts that belong together, edited in one place, then reused by a template. A field group, the set of fields ACF shows together and assigns to one or more content types, handles each case below.

A location rule decides where that group appears, for example "Post Type is equal to Product". Same idea for authors and events: define the fields once, let the template render them everywhere.

Man taking notes while reviewing a website on his laptop

03 / 09

ACF Free vs Pro: what actually changes?

Free covers the basics, text, image, select, date, and most single-value fields. Pro adds the composite field types that make repeating layouts practical.

Free gives you one value per field: text, image, select, date, and similar types. Pro adds Repeater, Flexible Content, Gallery, Clone, and Options Pages, plus ACF Blocks, a Pro feature that builds custom Gutenberg blocks from ACF fields and a template file.

Pro pays off as soon as the number of rows varies: team members, downloads, pricing tiers. Prices and renewals change, so treat any figure as an estimate until the official ACF pricing page confirms it that day.

Going further

Compare the two

04 / 09

How do I install ACF and create my first field group?

The walkthrough is short: install the plugin, open ACF in the admin menu, add a field group, add fields, set a location rule, and publish.

ACF sits under the editor, not on top of it: Gutenberg builds layout and content itself, page builders like Elementor handle layout plus styling, while ACF just adds extra fields. You'll see ACF's fields inside a meta box below the Gutenberg editor, or inside the builder's own editing panel.

Reach for ACF when your content needs a repeating structure your editor or builder doesn't store as data, a list of team members or pricing rows.

  1. Install the plugin

    In the WordPress admin, go to Plugins → Add New Plugin, search for 'Advanced Custom Fields', then click Install and Activate.

  2. Open the field group builder

    In the left admin menu, click ACF → Field Groups → Add New. Give the group a clear title.

  3. Add your first field

    Click Add Field and fill in Field Label (shown in the editor), Field Name (lowercase letters and underscores, used in code), and Field Type (such as Text).

  4. Add each remaining field

    Use Add Field again for every field you need in this group, so they all appear together.

  5. Set the location rule

    Under Location, add a rule such as 'Post Type is equal to Post'. That tells ACF where this field group shows up.

  6. Publish and check

    Click Publish, then open any post for editing. The fields now sit below the editor.

05 / 09

How do I actually display an ACF field on the page?

You read the value in your theme with get_field() (returns it) or the_field() (prints it), and you use the field name you set in the field group.

In your theme, use get_field(), an ACF PHP function that returns a field value, when you need to test or format it before printing. Use the_field(), which echoes the value directly, for plain output. Always wrap printing in a check (for example, if ( get_field('event_date') )) so empty fields don't leave stray labels.

In ACF 6.x, field groups and values are also exposed through the WordPress REST API and the block editor, so a hybrid theme can read the same field in PHP or in a Gutenberg block. ACF also ships shortcodes for quick insertion without touching template files.

  1. Pick a template

    Choose the theme file that renders the content type you want to change, for example, single-event.php for a single event post.

  2. Read the value with get_field()

    Call $location = get_field('event_location'); to store the field value in a variable. The first argument is the field name you set in the field group.

  3. Check the variable first: if ( $location ) { echo esc_html( $location ); }. This keeps empty fields from leaving labels on the page.

Going further

Show the code path

06 / 09

What does ACF not do on its own?

ACF manages data, not design. It does not build layouts, does not style anything, and does not guarantee that an old field group still fits a redesigned template.

ACF stores and returns values. How those values look is decided by your theme, block, or page builder. On a site with no custom template, fields exist in the database but never appear on the page.

Renaming a field key orphans the data stored under the old name until you migrate it yourself. And unlicensed copies of ACF Pro sit outside the developer's terms, with no official updates or support.

07 / 09

Do you actually need ACF?

Install ACF if you have repeating or structured content that WordPress does not model by default. Skip it if your site is a simple blog or is entirely built inside a page builder that already handles the content you need.

Say yes when the same set of attributes repeats across many entries: a product catalog with specs, a staff or location directory, an events calendar, or a portfolio where every project carries the same metadata. Those values belong in fields, not in body copy.

Say no when every page is one-off free-form writing, when a page builder already stores the data you need, or when your only extra content is a hero image and a subtitle. ACF and a builder usually coexist: the builder handles layout, ACF holds values a template or block must reuse.

The same fields repeat across many entries

If you would type the same labels and values on ten or more pages, ACF lets one field group define them once.

No page builder already stores that data

Check whether your builder's own modules or custom fields already hold these values before adding a second system.

You can edit a template or use a block

ACF stores values; something must output them. Confirm you or your developer can edit the theme template or use the ACF block.

You can test on a staging copy first

Field groups change the edit screens and the database. Try the setup on a staging copy before touching the live site.

You will keep the plugin updated

Field data lives in your database, so plan for regular updates and backups as part of normal site maintenance.

08 / 09

What should I do before installing ACF?

Back up the site, check your WordPress and PHP versions, install the free plugin on a staging copy first, and create one field group end to end before rolling it out.

Never install on the live site first. Copy the site to a staging environment, then confirm the plugin's current requirements on a source that actually states them: at the time of writing, ACF 6.8.9 (August 27, 2026) requires WordPress 6.2+ and PHP 7.4+, and is tested up to WordPress 7.1, per the plugin's GitHub release page. If your host runs an older PHP build, ask them to upgrade before you add fields.

Once the staging copy meets those versions, install the free plugin there and prove the whole chain once: create a field group, attach it to a single post type, output it in one template, and check the front end. Only after that single field renders correctly should you repeat the pattern on production.

  1. Back up the site

    Export a full backup of files and database so you can roll back if anything breaks on the staging copy.

  2. Check versions

    Confirm your WordPress and PHP versions meet ACF 6.8.9's stated minimums: WordPress 6.2+ and PHP 7.4+, per the plugin's GitHub release page (August 27, 2026).

  3. Install on staging

    Install the free ACF plugin on a staging copy of the site, not on production.

  4. Create one field group

    In the WordPress admin, go to ACF > Field Groups > Add New, add a text field called, say, subtitle, and set its location rule to Post Type = Post.

  5. Display it in one template

    In your theme, use the_field('subtitle') inside the post template, then check the field appears correctly on the front end.

  6. Roll out

    Once the single field group works end to end, replicate the same pattern for the other post types or pages you need.

09 / 09

Frequently asked questions

Frequently asked questions
The Web Insider editorial team
About the author The Web Insider editorial team

Web Insider is a practical magazine for people who build, run or grow a website. Every fact is checked against its official source, and every test shows its proof.

Your feedback

Was this page helpful?

Share

Could this page help someone?

Related reading

Read next

Two colleagues reviewing a website admin screen on a large monitor
Websites & Platforms

WordPress Admin: How to Log In and Manage Your Site Safely

The WordPress admin lives at yourdomain.com/wp-admin on self-hosted sites, and behind the WordPress.com dashboard on hosted ones. Here is how to log in safely, find your way around, and recover access when something breaks.

·16 min
Small web team working together at a desk with a website on screen
Websites & Platforms

WordPress Cron Jobs: Fix Missed Schedules

WP-Cron is not a real scheduler: it checks for due tasks on every page load. Here is how it works, why tasks run late, and how to make them reliable.

·15 min
E-commerce team checking store tracking on a laptop
Websites & Platforms

Google Tag Manager on PrestaShop: What to Check

GTM on PrestaShop only works when the container loads everywhere and a data layer feeds it real order values. Here is the order to check things so you find what is broken.

·17 min
Two colleagues arranging blank planning cards on a dark wall board
Websites & Platforms

How to Organize a WordPress Site So It Stays Easy to Run

A practical system for solo owners and small teams who need their WordPress site to stay manageable as it grows. Pages vs posts, taxonomy, media, roles, and maintenance routines.

·16 min
Analyst reviewing tag routing on a large wall screen
Websites & Platforms

GTM on WordPress: Install It Without Skewing Data

A non-commercial walkthrough to get your GTM container live on WordPress in under 30 minutes. The real work is data integrity: one method, no duplicate tags, verified before publish.

·16 min
Explore the topicData & Analytics

Audience measurement, Google Analytics 4 and Google Tag Manager: set them up, check them and keep your data reliable.

Explore the topicWebsites & Platforms

WordPress, Shopify, PrestaShop and WooCommerce: run, integrate and maintain a site without making it fragile.

Explore the topicGuides & How-Tos

Methods, training and practical benchmarks to scope a web project, test a site and make better decisions.

Explore the topicSecurity & Compliance

Backups, updates, GDPR, cookies and audience measurement: keep a site safe and compliant.