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.

Was this article helpful?

Not really

Yes, Thanks

Can't find what you're looking for? Get in touch with us on our Community Forum.