Tax queries and meta queries in Wordpress - Step-by-Step Execution

Concept Flow - Tax queries and meta queries

Start WP_Query

↓

Set query args

↓

Add tax_query array?

No→Skip tax filter

Yes↓

Add meta_query array?

No→Skip meta filter

Yes↓

WP_Query runs SQL with filters

↓

Return filtered posts

↓

Display posts

WordPress builds a query with tax and meta filters, runs it, and returns posts matching those filters.

Execution Sample

Wordpress

$query = new WP_Query(array(
  'tax_query' => array(array('taxonomy' => 'category', 'field' => 'slug', 'terms' => array('news'))),
  'meta_query' => array(array('key' => 'featured', 'value' => '1', 'compare' => '='))
));

This code queries posts in the 'news' category with meta key 'featured' equal to '1'.

Execution Table

Step	Action	tax_query	meta_query	SQL Filter	Resulting Posts
1	Initialize WP_Query	empty	empty	none	all posts
2	Add tax_query filter	[{taxonomy:'category',field:'slug',terms:['news']}]	empty	WHERE category.slug IN ('news')	posts in 'news' category
3	Add meta_query filter	[{taxonomy:'category',field:'slug',terms:['news']}]	[{key:'featured',value:'1',compare:'='}]	WHERE category.slug IN ('news') AND meta_key='featured' AND meta_value='1'	posts in 'news' category with featured=1
4	Run query	[{taxonomy:'category',field:'slug',terms:['news']}]	[{key:'featured',value:'1',compare:'='}]	Combined tax and meta filters	filtered posts returned
5	Display posts	same	same	same	posts shown on page
6	End	same	same	same	query complete

💡 Query ends after posts matching tax and meta filters are retrieved and displayed.

Variable Tracker

Variable	Start	After Step 2	After Step 3	Final
tax_query	empty	[{taxonomy:'category',field:'slug',terms:['news']}]	[{taxonomy:'category',field:'slug',terms:['news']}]	[{taxonomy:'category',field:'slug',terms:['news']}]
meta_query	empty	empty	[{key:'featured',value:'1',compare:'='}]	[{key:'featured',value:'1',compare:'='}]
SQL Filter	none	WHERE category.slug IN ('news')	WHERE category.slug IN ('news') AND meta_key='featured' AND meta_value='1'	Combined tax and meta filters

Key Moments - 3 Insights

Why do tax_query and meta_query filters combine with AND in the SQL?

Because in the execution_table step 3, both filters are added together, so posts must match both tax and meta conditions.

What happens if tax_query is empty but meta_query has filters?

From step 2 and 3, tax_query is skipped, so only meta_query filters apply, returning posts matching meta conditions only.

Can tax_query filter multiple taxonomies at once?

Yes, tax_query can be an array of multiple taxonomy filters combined with relation (AND/OR), as shown by the array structure in step 2.

Visual Quiz - 3 Questions

Look at the execution_table at step 3, what SQL filter is added?

A WHERE category.slug IN ('news')

B WHERE category.slug IN ('news') AND meta_key='featured' AND meta_value='1'

C AND meta_key='featured' AND meta_value='1'

D No SQL filter added

💡 Hint

Check the 'SQL Filter' column at step 3 in the execution_table.

According to variable_tracker, what is the value of meta_query after step 2?

A empty

B [{key:'featured',value:'1',compare:'='}]

C [{taxonomy:'category',field:'slug',terms:['news']}]

D none

💡 Hint

Look at the 'meta_query' row and 'After Step 2' column in variable_tracker.

If we remove tax_query from the query args, what changes in the execution_table?

A meta_query is removed too

B Step 2 tax_query remains the same

C Step 2 tax_query is empty and SQL filter skips tax condition

D Query returns all posts without filters

💡 Hint

Refer to key_moments about what happens if tax_query is empty.

Concept Snapshot

WP_Query tax_query and meta_query filters posts by taxonomy terms and custom fields.
Use tax_query to filter categories, tags, or custom taxonomies.
Use meta_query to filter posts by custom field values.
Both filters combine with AND by default.
They build SQL WHERE clauses to fetch matching posts.
Add arrays of conditions for complex queries.

Full Transcript

This visual execution shows how WordPress WP_Query uses tax_query and meta_query to filter posts. First, tax_query filters posts by taxonomy terms like categories. Then meta_query filters posts by custom field values. Both filters combine to build SQL WHERE clauses. The query runs and returns posts matching all filters. Variables tax_query and meta_query update step-by-step. Key moments clarify how filters combine and what happens if one is missing. The quiz tests understanding of SQL filters and variable states. This helps beginners see how WordPress queries posts with tax and meta conditions.

Practice

1. Which of the following best describes a tax_query in WordPress?

easy

A. It filters posts based on custom field values.

B. It sorts posts by date or title.

C. It filters posts based on categories, tags, or custom taxonomies.

D. It updates post metadata values.

Solution

1. Step 1: Understand tax_query purpose

   A tax_query is used to filter posts by taxonomy terms like categories or tags.

2. Step 2: Compare with meta_query

   A meta_query filters by custom fields, not taxonomies.

3. Final Answer:

   It filters posts based on categories, tags, or custom taxonomies. -> Option C

4. Quick Check:

   tax_query = taxonomy filter [OK]

Hint: Tax queries filter by taxonomy terms like categories [OK]

Common Mistakes:

• Confusing tax_query with meta_query
• Thinking tax_query sorts posts
• Assuming tax_query updates data

2. Which of the following is the correct syntax to create a meta query filtering posts where the meta key 'color' equals 'blue'?

easy

A. tax_query => [ ['taxonomy' => 'color', 'field' => 'slug', 'terms' => 'blue'] ]

B. meta_query => [ ['key' => 'color', 'value' => 'blue', 'compare' => '='] ]

C. meta_query => [ ['key' => 'color', 'value' => 'blue', 'compare' => 'LIKE'] ]

D. meta_query => [ ['key' => 'color', 'value' => ['blue'], 'compare' => 'IN'] ]

Solution

1. Step 1: Identify meta_query structure

   A meta query uses 'key', 'value', and 'compare' keys to filter custom fields.

2. Step 2: Match exact equality

   To check exact match, 'compare' should be '=' and 'value' a string, not array.

3. Final Answer:

   meta_query => [ ['key' => 'color', 'value' => 'blue', 'compare' => '='] ] -> Option B

4. Quick Check:

   Exact match uses compare '=' [OK]

Hint: Use compare '=' for exact meta key-value match [OK]

Common Mistakes:

• Using tax_query instead of meta_query
• Using 'LIKE' when exact match needed
• Passing value as array when not needed

3. What will the following query return?

query_posts([
  'tax_query' => [[
    'taxonomy' => 'category',
    'field' => 'slug',
    'terms' => ['news', 'updates'],
    'operator' => 'AND'
  ]],
  'meta_query' => [[
    'key' => 'featured',
    'value' => '1',
    'compare' => '='
  ]]
]);

medium

A. Syntax error due to incorrect tax_query format.

B. Posts in either 'news' OR 'updates' categories with meta 'featured' = '1'.

C. Posts with meta 'featured' = '1' ignoring categories.

D. Posts in both 'news' AND 'updates' categories with meta 'featured' = '1'.

Solution

1. Step 1: Analyze tax_query operator

   Operator 'AND' means posts must be in both 'news' and 'updates' categories simultaneously.

2. Step 2: Analyze meta_query condition

   Meta query filters posts where 'featured' meta key equals '1'.

3. Final Answer:

   Posts in both 'news' AND 'updates' categories with meta 'featured' = '1'. -> Option D

4. Quick Check:

   tax_query 'AND' + meta_query '=' = Posts in both 'news' AND 'updates' categories with meta 'featured' = '1'. [OK]

Hint: Operator 'AND' means all terms must match in tax_query [OK]

Common Mistakes:

• Confusing 'AND' with 'OR' operator
• Ignoring meta_query filter
• Assuming syntax error incorrectly

4. Identify the error in this tax query:

$args = [
  'tax_query' => [
    'taxonomy' => 'genre',
    'field' => 'slug',
    'terms' => 'fiction'
  ]
];
$query = new WP_Query($args);

medium

A. tax_query must be an array of arrays, but here it's a single array.

B. The 'terms' value must be an array, not a string.

C. The 'field' key is invalid in tax_query.

D. WP_Query does not accept tax_query parameter.

Solution

1. Step 1: Check tax_query structure

   tax_query expects an array of arrays, each inner array defines one taxonomy filter.

2. Step 2: Identify the provided structure

   Here tax_query is a single associative array, missing the outer array wrapping.

3. Final Answer:

   tax_query must be an array of arrays, but here it's a single array. -> Option A

4. Quick Check:

   tax_query = array of arrays [OK]

Hint: tax_query always needs an outer array wrapping inner arrays [OK]

Common Mistakes:

• Passing single array instead of array of arrays
• Thinking 'terms' must always be array
• Ignoring tax_query structure rules

5. You want to query posts that are in the 'events' category AND have a custom field 'priority' set to 'high'. Which is the correct way to combine tax_query and meta_query to achieve this?

medium

A. Use 'relation' => 'AND' to combine tax_query and meta_query for AND behavior.

B. Nest tax_query and meta_query inside a 'relation' => 'OR' array within 'meta_query'.

C. Combine tax_query and meta_query inside a single array without 'relation'.

D. Use 'relation' => 'OR' at the top level combining tax_query and meta_query arrays.

Solution

1. Step 1: Understand combining queries

   tax_query and meta_query are combined with AND logic by default when both are included in the query args.

2. Step 2: Correct structure

   Simply place both 'tax_query' and 'meta_query' as keys in the main query args array; no 'relation' is needed.

3. Final Answer:

   Combine tax_query and meta_query inside a single array without 'relation'. -> Option A

4. Quick Check:

   tax_query + meta_query default = AND [OK]

Hint: tax_query and meta_query default to AND logic [OK]

Common Mistakes:

• Adding unnecessary 'relation' => 'AND'
• Nesting queries inside one another
• Using 'relation' => 'OR' for AND logic