A reference to a document in a Firestore database.
The document may already exist or can be created by this class.
Parameters
Name
Description
path
Tuple[str, ...]
The components in the document path. This is a series of strings representing each collection and sub-collection ID, as well as the document IDs for any documents that contain a sub-collection (as well as the base document).
kwargs
dict
The keyword arguments for the constructor. The only supported keyword is client and it must be a Client. It represents the client that created this document reference.
Exceptions
Type
Description
ValueError
if * the path is empty * there are an even number of elements * a collection ID in path is not a string * a document ID in path is not a string
[[["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"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Module document (2.21.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.21.0 (latest)](/python/docs/reference/firestore/latest/google.cloud.firestore_v1.document)\n- [2.20.2](/python/docs/reference/firestore/2.20.2/google.cloud.firestore_v1.document)\n- [2.19.0](/python/docs/reference/firestore/2.19.0/google.cloud.firestore_v1.document)\n- [2.18.0](/python/docs/reference/firestore/2.18.0/google.cloud.firestore_v1.document)\n- [2.17.2](/python/docs/reference/firestore/2.17.2/google.cloud.firestore_v1.document)\n- [2.16.1](/python/docs/reference/firestore/2.16.1/google.cloud.firestore_v1.document)\n- [2.15.0](/python/docs/reference/firestore/2.15.0/google.cloud.firestore_v1.document)\n- [2.14.0](/python/docs/reference/firestore/2.14.0/google.cloud.firestore_v1.document)\n- [2.13.1](/python/docs/reference/firestore/2.13.1/google.cloud.firestore_v1.document)\n- [2.12.0](/python/docs/reference/firestore/2.12.0/google.cloud.firestore_v1.document)\n- [2.11.1](/python/docs/reference/firestore/2.11.1/google.cloud.firestore_v1.document)\n- [2.10.1](/python/docs/reference/firestore/2.10.1/google.cloud.firestore_v1.document)\n- [2.9.1](/python/docs/reference/firestore/2.9.1/google.cloud.firestore_v1.document)\n- [2.8.0](/python/docs/reference/firestore/2.8.0/google.cloud.firestore_v1.document)\n- [2.7.3](/python/docs/reference/firestore/2.7.3/google.cloud.firestore_v1.document)\n- [2.6.1](/python/docs/reference/firestore/2.6.1/google.cloud.firestore_v1.document)\n- [2.5.3](/python/docs/reference/firestore/2.5.3/google.cloud.firestore_v1.document)\n- [2.4.0](/python/docs/reference/firestore/2.4.0/google.cloud.firestore_v1.document)\n- [2.3.4](/python/docs/reference/firestore/2.3.4/google.cloud.firestore_v1.document)\n- [2.2.0](/python/docs/reference/firestore/2.2.0/google.cloud.firestore_v1.document)\n- [2.1.3](/python/docs/reference/firestore/2.1.3/google.cloud.firestore_v1.document)\n- [2.0.2](/python/docs/reference/firestore/2.0.2/google.cloud.firestore_v1.document)\n- [1.9.2](/python/docs/reference/firestore/1.9.2/google.cloud.firestore_v1.document)\n- [1.8.1](/python/docs/reference/firestore/1.8.1/google.cloud.firestore_v1.document)\n- [1.7.0](/python/docs/reference/firestore/1.7.0/google.cloud.firestore_v1.document)\n- [1.6.2](/python/docs/reference/firestore/1.6.2/google.cloud.firestore_v1.document)\n- [1.5.0](/python/docs/reference/firestore/1.5.0/google.cloud.firestore_v1.document)\n- [1.4.0](/python/docs/reference/firestore/1.4.0/google.cloud.firestore_v1.document)\n- [1.3.0](/python/docs/reference/firestore/1.3.0/google.cloud.firestore_v1.document) \nClasses for representing documents for the Google Cloud Firestore API.\n\nClasses\n-------\n\n### [DocumentReference](/python/docs/reference/firestore/latest/google.cloud.firestore_v1.document.DocumentReference)\n\n DocumentReference(*path, **kwargs)\n\nA reference to a document in a Firestore database.\n\nThe document may already exist or can be created by this class."]]