Delete a Firestore collection (async)
Stay organized with collections
Save and categorize content based on your preferences.
Delete a Firestore collection and documents within (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 sample demonstrates how to asynchronously delete a Firestore collection and its documents.\u003c/p\u003e\n"],["\u003cp\u003eThe function \u003ccode\u003edelete_collection\u003c/code\u003e recursively deletes documents in batches to efficiently remove an entire collection.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to Firestore requires setting up Application Default Credentials.\u003c/p\u003e\n"],["\u003cp\u003eDetailed documentation on deleting data in Firestore is available at the provided links.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Cloud sample browser can be referenced for more samples on Google Cloud products.\u003c/p\u003e\n"]]],[],null,["# Delete a Firestore collection (async)\n\nDelete a Firestore collection and documents within (async).\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Delete data from Cloud Firestore](https://firebase.google.com/docs/firestore/manage-data/delete-data)\n- [Delete documents and fields](/firestore/native/docs/manage-data/delete-data)\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 async def delete_collection(coll_ref, batch_size):\n docs = coll_ref.limit(batch_size).stream()\n deleted = 0\n\n async for doc in docs:\n print(f\"Deleting doc {doc.id} =\u003e {doc.to_dict()}\")\n await doc.reference.delete()\n deleted = deleted + 1\n\n if deleted \u003e= batch_size:\n return delete_collection(coll_ref, batch_size)\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)."]]