Query by language

If you are taking advantage of the Localization feature in your Prismic repository, then you'll need to be able to query documents by a specific language. This page will show you how retrieve documents by language.

Query documents of a certain language

To specify a particular language you want in a query, simply add the lang option set to the language code you are querying (example, "en-us" for American English).

If you don't specify a "lang" the system will by default query the documents in your master language.

Here's an example of how to query all the documents of the type "blog-post" in Traditional French ("fr-fr").

Copy

// To retrieve the API object check out How to query the API
api.query(
    Prismic.Predicates.at('document.type', 'blog-post'),
    { lang : 'fr-fr' }
).then(function(response) {
    // response is the response object, response.results holds the documents
});

Query documents in all languages

If you want to query all the document of the same type in all languages you can just add the wildcard value '*' as your lang option.

Here is an example that queries all the documents of the type "blog-post" in all the available languages.

Copy

// To retrieve the API object check out How to query the API
api.query(
    Prismic.Predicates.at('document.type', 'blog-post'),
    { lang : '*' }
).then(function(response) {
    // response is the response object, response.results holds the documents
});

Query by UID & language

To learn more about how to query your documents by UID and language, check out the Query by ID and UID page.