WPGraphQL for ACF

WPGraphQL for Advanced Custom Fields is a free, open-source WordPress plugin that adds ACF Fields and Field Groups to the WPGraphQL Schema.

Create ACF Field Groups

Create ACF Field Groups and Fields using the ACF User Interface, register them with PHP, or leverage ACF local JSON. ”

Query your fields with GraphQL

Once your field groups and fields are configured to “Show in GraphQL,” they become available in the GraphQL Schema for querying.

Supported Field Types

WPGraphQL for ACF provides support for most built-in field types of ACF (free & PRO) and extends support to most field types from ACF Extended (free & PRO).

Updating

* or older, check out the Upgrade Guide

For non-major version updates, automatic updates usually should work smoothly, but we still recommend you back up your site and test on a staging site.

Before updating WPGraphQL for ACF, review the release notes on GitHub. Look for releases tagged with wp-graphql-acf/v*.

We follow Semantic Versioning (Semver) for meaningful releases:

• MAJOR version for incompatible API changes,

• MINOR version for backwards-compatible functionality additions,

• PATCH version for backwards-compatible bug fixes.

org.

Support

• General Help Requests: For general questions and help requests, create a new topic in Github Discussions

• Discord Community: The WPGraphQL Discord is a great place to communicate in real-time. Ask questions, discuss features, get to know other folks using WPGraphQL.

• Bug Reports: Report a bug in WPGraphQL

• Feature Requests: Suggest an idea, feature, or enhancement for WPGraphQL.

• Report a Security Vulnerability: Report a security vulnerability.

FAQs

Does this work with ACF Extended?

Yes! WPGraphQL for ACF allows you to query for (most) fields created with ACF Extended.

Can I filter and sort queries by ACF Fields using WPGraphQL for ACF?

At this time WPGraphQL for ACF does not support filtering or sorting queries by ACF Fields. “Meta Queries” are often very expensive to execute, so we currently do not support filtering by ACF fields out of the box, but are exploring options for supporting it without the performance penalty.

I think I found a bug, where do I report it?

If you think you found a bug, please open a bug report in the WPGraphQL monorepo and pick “WPGraphQL for ACF” from the plugin dropdown. The more details you provide in the issue, and the more clear your steps to reproduce are, the higher chances we will be able to help.

Can I use ACF Free or Pro with WPGraphQL for ACF?

Yes! WPGraphQL for ACF works great with ACF Free and Pro. The Pro version of ACF has some additional features, such as Flexible Content Fields, Repeater Fields and Options Pages that are supported by WPGraphQL for ACF.

Does WPGraphQL for ACF work with Secure Custom Fields?

Yes. org fork of ACF, is supported the same way as ACF Pro: it includes the Pro field types (such as Repeater, Flexible Content and Clone fields), Options Pages and ACF Blocks, and WPGraphQL for ACF exposes them all. The full test suite runs against SCF in CI.

Install either ACF or SCF, not both.

js to use WPGraphQL for ACF?

No! js, etc.

I have an ACF Extension that adds a new field type, will it work with WPGraphQL for ACF?

WPGraphQL for ACF supports the field types that come with ACF (Free and PRO) as well as the field types in ACF Extended (Free and PRO). Support for additional field types can be added by using the “register_graphql_acf_field_type” API.

Do I need WPGraphQL and ACF to be active to use this?

This plugin is a “bridge” plugin that brings functionality of ACF to WPGraphQL. Both WPGraphQL and ACF need to be installed and active in your WordPress installation for this plugin to work.

How much does WPGraphQL for ACF cost?

WPGraphQL for ACF is a FREE open-source plugin. The development is sponsored by WP Engine Atlas.

Does WPGraphQL for ACF support GraphQL Mutations?

Not yet. WPGraphQL for ACF exposes ACF fields for reading today, but creating and updating field values through GraphQL mutations isn’t built yet. Follow the mutation support feature request for progress.

Does this work with Field Groups registered in PHP or JSON?

Yes! You can register ACF Field Groups and Fields using the Admin UI, PHP or JSON. WPGraphQL for ACF will detect the Field Groups and Fields and add them to the GraphQL Schema.

If using PHP or JSON, you will need to set the “show_in_graphql” setting to “true” to expose the Field Group and Fields to the GraphQL Schema. There might be other settings that need attention at the field group or field level that might impact the schema or field resolution.

Privacy Policy

WPGraphQL for Advanced Custom Fields uses Appsero SDK to collect telemetry data upon user confirmation, helping us troubleshoot problems and improve the product.

The Appsero SDK doesn’t collect data by default and only starts gathering basic telemetry data when a user allows it via the admin notice. No data is collected without user consent.

com (the same categories of data as described for Appsero below).

Learn more about how Appsero collects and uses data.