Query a Firestore collection with an array_contains filter (async)
Stay organized with collections
Save and categorize content based on your preferences.
Query a Firestore collection with an array_contains filter (async).
Explore further
For detailed documentation that includes this code sample, see the following:
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis code demonstrates querying a Firestore collection using an \u003ccode\u003earray_contains\u003c/code\u003e filter.\u003c/p\u003e\n"],["\u003cp\u003eThe code sample utilizes the \u003ccode\u003eFieldFilter\u003c/code\u003e to search for documents where the "regions" field contains "west_coast" within an array.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to Firestore is required, using Application Default Credentials.\u003c/p\u003e\n"],["\u003cp\u003eFurther details and related documentation can be found in the "Perform simple and compound queries" and "Query and filter data" guides.\u003c/p\u003e\n"]]],[],null,["# Query a Firestore collection with an array_contains filter (async).\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Perform simple and compound queries in Cloud Firestore](https://firebase.google.com/docs/firestore/query-data/queries)\n- [Query and filter data](/firestore/native/docs/query-data/queries)\n\nCode sample\n-----------\n\n### Python\n\n\nTo authenticate to Firestore, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n cities_ref = db.collection(\"cities\")\n\n query = cities_ref.where(\n filter=FieldFilter(\"regions\", \"array_contains\", \"west_coast\")\n )\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=firestore)."]]