[Home](./index.md) > [@firebase/firestore](./firestore.md) > [/](./firestore_.md) > [DocumentReference](./firestore_.documentreference.md) ## DocumentReference class A `DocumentReference` refers to a document location in a Firestore database and can be used to write, read, or listen to the location. The document at the referenced location may or may not exist. Signature: ```typescript export declare class DocumentReference ``` ## Properties | Property | Modifiers | Type | Description | | --- | --- | --- | --- | | [firestore](./firestore_.documentreference.firestore.md) | | [FirebaseFirestore](./firestore_.firebasefirestore.md) | The [FirebaseFirestore](./firestore_.firebasefirestore.md) the document is in. This is useful for performing transactions, for example. | | [id](./firestore_.documentreference.id.md) | | string | The document's identifier within its collection. | | [parent](./firestore_.documentreference.parent.md) | | [CollectionReference](./firestore_.collectionreference.md)<T> | The collection this DocumentReference belongs to. | | [path](./firestore_.documentreference.path.md) | | string | A string representing the path of the referenced document (relative to the root of the database). | | [type](./firestore_.documentreference.type.md) | | (not declared) | The type of this Firestore reference. | ## Methods | Method | Modifiers | Description | | --- | --- | --- | | [withConverter(converter)](./firestore_.documentreference.withconverter.md) | | Applies a custom data converter to this DocumentReference, allowing you to use your own custom model objects with Firestore. When you call [setDoc()](./firestore_lite.setdoc.md), [getDoc()](./firestore_lite.getdoc.md), etc. with the returned DocumentReference instance, the provided converter will convert between Firestore data and your custom type U. | | [withConverter(converter)](./firestore_.documentreference.withconverter_1.md) | | Removes the current converter. |