get_meta_sql( array $meta_query, string $type, string $primary_table, string $primary_id_column, object $context = null )

Given a meta query, generates SQL clauses to be appended to a main query.

Description Description

See also See also

Top ↑

Parameters Parameters


(array) (Required) A meta query.


(string) (Required) Type of meta.


(string) (Required) Primary database table name.


(string) (Required) Primary ID column name.


(object) (Optional) The main query object

Default value: null

Top ↑

Return Return

(array) Associative array of JOIN and WHERE SQL.

Top ↑

Source Source

File: wp-includes/meta.php

function get_meta_sql( $meta_query, $type, $primary_table, $primary_id_column, $context = null ) {
	$meta_query_obj = new WP_Meta_Query( $meta_query );
	return $meta_query_obj->get_sql( $type, $primary_table, $primary_id_column, $context );

Top ↑

Changelog Changelog

Version Description
3.2.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex


    $meta_query = array(
    		'key' => 'color',
    		'value' => 'blue',
    		'compare' => 'NOT LIKE'
    global $wpdb;
    $meta_sql = get_meta_sql( $meta_query, 'post', $wpdb->posts, 'ID' );

    Output depending on the meta query:

        [join] =>  INNER JOIN wp_postmeta ON (wp_posts.ID = wp_postmeta.post_id)
        [where] =>  AND ( (wp_postmeta.meta_key = 'color' AND CAST(wp_postmeta.meta_value AS CHAR) NOT LIKE '%blue%') )

You must log in before being able to contribute a note or feedback.