WPGraphQL for ACF

Your ACF fields,
automatically in GraphQL.

Expose your Advanced Custom Fields groups and fields to the WPGraphQL schema with a single “Show in GraphQL” toggle — no resolvers, no glue code.

Free & open source · Requires WPGraphQL + ACF

How it works

Flip a toggle.
Query your fields.

No custom resolvers, no register_graphql_field boilerplate — just your fields, in the schema.

Flip the 'Show in GraphQL' toggle

Build your Field Groups and Fields exactly as you do today — in the ACF UI, in PHP, or with local JSON. Each group and field gets a 'Show in GraphQL' setting; turn it on and the plugin maps it into the schema for you.

Field Group · Page FieldsShow in GraphQL ✓
Field nameType
heroHeadingText
heroImageImage
ctaButtonsRepeater
layoutFlexible Content
Query your fields with GraphQL

Exposed field groups appear on the types they're assigned to — posts, pages, taxonomies, users, options pages and more — ready to query like any other WPGraphQL field, with the correct GraphQL types inferred automatically.

query PageFields {
page(id: "/", idType: URI) {
pageFields {
heroHeading
ctaButtons { label url }
}
}
}
Why WPGraphQL for ACF

Skip the glue code.
Ship content faster.

Skip the glue code

Exposing fields to the schema by hand is tedious and error-prone. WPGraphQL for ACF maps your field groups automatically, so you spend time building features instead of wiring up resolvers.

Nearly every field type

Most ACF Free and Pro field types are supported out of the box — including Repeater, Flexible Content, Group, and Gallery — plus most field types from ACF Extended (Free and Pro).

Fast, and client-agnostic

Built on WPGraphQL, it brings the same query performance to your ACF data — and works with Apollo, Relay, urql, Faust.js, or any GraphQL client you already use.

Supported fields

Nearly every ACF field,
out of the box.

Text
Text Area
Number
Range
Email
URL
Password
Image
File
WYSIWYG
oEmbed
Select
Checkbox
Radio Button
Button Group
True / False
Link
Post Object
Page Link
Relationship
Taxonomy
User
Google Map
Date Picker
Date/Time Picker
Time Picker
Color Picker
Group
Repeater
Flexible Content
Gallery

Support extends to most field types from ACF Extended (Free & Pro) too. A few non-data fields — such as Accordion, Tab, and Message — aren't represented in the schema, and new field types can be added with the register_graphql_acf_field_type API.

Pricing & support

Free and open source.
Built in the open.

WPGraphQL for ACF is a FREE open-source plugin. The code is on GitHub; report bugs or request features through issues, and visit the WPGraphQL Discord for general questions.

FAQ

Frequently asked
questions.

Add ACF to your
GraphQL schema today.

Install from WordPress.org and expose your Advanced Custom Fields in minutes.