WP Plugin · Custom Fields

Queryra + ACF

Works out of the box

ACF (Advanced Custom Fields) and Queryra work together with no configuration. Standard product and post information, taxonomies, WooCommerce attributes, and the values stored in your ACF fields are all indexed automatically — the plugin reads field values via ACF's get_fields() API during sync (text, textarea, wysiwyg, select, and similar text-yielding types).

Tested with

ACF 6.x (free & Pro)

Queryra plugin

v1.3+

Setup time

0 minutes

What works automatically

  • Standard post fields — title, content, and excerpt
  • For products: short description, price, stock, SKU, and featured image
  • All WooCommerce product attributes — both global (Products → Attributes) and custom per-product attributes
  • Standard categories and tags, plus brand from the major brand plugins (WooCommerce native, YITH, Perfect Brands)
  • Re-indexing happens automatically whenever you save a post or product in the WordPress editor — ACF doesn’t need a separate trigger
  • No configuration to make ACF and Queryra coexist — install both, you’re done

One ACF-specific note: if your theme renders ACF values into the post content (so they appear in the body of the post when published), those values are already searchable because Queryra reads the published post content directly.

Optional fallbacks for edge cases

The current Queryra plugin reads ACF field values automatically via get_fields() during sync — no setup needed for standard text-yielding field types. Complex nested types (repeater rows, flexible content blocks, group fields) are flattened and indexed too. Three alternative approaches below remain useful only if you have a non-standard setup or want different behaviour:

1

Use ACF's "Taxonomy" field type

Easiest option. Zero code. About 2 minutes.

Instead of choosing a text or select field when you set up your custom field in ACF, choose "Taxonomy". Point it at one of the searchable taxonomies — product tag works for most cases. Make sure the Save Terms option is enabled. Once you do, every value you fill in becomes a regular WordPress tag, which Queryra already reads. Best when your values are a finite list (like Cotton, Wool, Linen).

2

Use a WooCommerce product attribute

Best for product-specific facets. Zero code.

If your custom field is product-specific — Color, Size, Material, Pattern — define it under Products → Attributes in WooCommerce instead of as an ACF field. All WooCommerce attributes are searchable automatically. You also get attribute filtering and display on the product page from one place. The trade-off: this works for products only, not posts or pages.

3

Mirror to a tag with a save hook

For when you want the ACF editor experience but searchable values.

A small snippet of code copies the value of your ACF field to a product tag every time the field is saved. The ACF field stays a regular text or select for the editor; Queryra reads the mirrored tag. Requires a developer or comfort editing your theme's functions file. Email contact@queryra.com if you'd like the snippet.

Troubleshooting

If search isn't showing results after setup, the most common causes are: incomplete import, sync frequency too low for testing, or a conflict with another search plugin (FiboSearch, Relevanssi, SearchWP).

Full troubleshooting guide — fix in 5 minutes

More questions? See the general FAQ or email contact@queryra.com.

Try Queryra freeWordPress plugin docs

Last updated: May 6, 2026 · Last tested with ACF 6.x (free & Pro) and Queryra plugin 1.2.x.