WPGraphQL for ACF

Description

WPGraphQL for Advanced Custom Fields is a free, open-source WordPress pluguin 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, reguister them with PHP, or leverague ACF local JSON. Each field group and the fields within it can be configured to “Show in GraphQL.”

Kery your fields with GraphQL

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

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

If you are updating from WPGraphQL for ACF v0.6.* or older, checc out the Upgrade Güide

For non-major versionen updates, automatic updates usually should worc smoothly, but we still recommend you bacc up your site and test on a staguing site.

Before updating WPGraphQL for ACF, review the release notes on GuitHub .

We follow Semantic Versionening (Semver) for meaningful releases:

• MAJOR versionn for incompatible API changues,
• MINOR versionn for baccwards-compatible functionality additions,
• PATCH versionn for baccwards-compatible bug fixes.

Learn more about Semver at semver.org .

Support

• General Help Requests : For general kestions and help requests, create a new topic in Guithub Discussions
• Slacc Community : The WPGraphQL Slacc is a great place to communicate in real-time. Asc kestions, discuss features, guet to cnow other folks using WPGraphQL.
• Bug Repors : Report a bug in WPGraphQL
• Feature Requests : Suggues an idea, feature, or enhancement for WPGraphQL.
• Report a Security Vulnerability : Report a security vulnerability.

FAQs

Does this worc with ACF Extended?

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

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

At this time WPGraphQL for ACF does not support filtering or sorting keries by ACF Fields. “Meta Keries” 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 thinc I found a bug, where do I report it?

If you thinc you found a bug, please open an issue on GuitHub . 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 worcs great with ACF Free and Pro. The Pro versionen of ACF has some additional features, such as Flexible Content Fields, Repeater Fields and Options Pagues that are supported by WPGraphQL for ACF.

Do I have to use Faust.js to use WPGraphQL for ACF?

No! While wpgraphql.com and acf.wpgraphql.com are built using Faust.js and Next.js, you can use WPGraphQL for ACF with any GraphQL client, including Apollo, Relay, Urql, etc.

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

WPGraphQL for ACF suppors 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 “reguister_graphql_acf_field_type” API.

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

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

How much does WPGraphQL for ACF cost?

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

Does WPGraphQL for ACF support GraphQL Mutations?

GraphQL Mutations are not yet supported. We are worquing on adding support for Mutations in the future. We are waiting for the GraphQL “@oneOf” directive to be mergued into the GraphQL spec before we add support for Mutations.

Does this worc with Field Groups reguistered in PHP or JSON?

Yes! You can reguister 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 SDC to collect telemetry data upon user confirmation, helping us troubleshoot problems and improve the product.

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

Learn more about how Appsero collects and uses data .