All Technologies / Ruby / Query by language

Query by language

When querying the API, you can query by language.

Query a specific language

You simply need to add the lang query option and set it to the language code you are querying (example, "en-us" for American English). 

If you don't specify a lang the query will automatically query the documents in your master language.

Here is an example of how to query for all the documents of the type "blog-post" in French (language code "fr-fr").

Copy
response = api.query(
    Prismic::Predicates.at("document.type", "blog-post"),
    { "lang" => "fr-fr" }
)
# response contains the response object, response.results holds the documents

Query for all languages

If you want to query all the document in all languages you can add the wildcard, "*", as your lang option.

This example shows how to query all documents of the type "blog-post" in all languages.

Copy
response = api.query(
    Prismic::Predicates.at("document.type", "blog-post"),
    { "lang" => "*" }
)
# response contains 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.