veritatisdoloremque/docs-exp/firestore_.collectionreference.withconverter.md

Monorepo for the Firebase JavaScript SDK

<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@firebase/firestore](./firestore.md) &gt; [/](./firestore_.md) &gt; [CollectionReference](./firestore_.collectionreference.md) &gt; [withConverter](./firestore_.collectionreference.withconverter.md)

## CollectionReference.withConverter() method

Applies a custom data converter to this CollectionReference, allowing you to use your own custom model objects with Firestore. When you call [addDoc()](./firestore_.adddoc.md) with the returned `CollectionReference` instance, the provided converter will convert between Firestore data and your custom type `U`<!-- -->.

<b>Signature:</b>

```typescript
withConverter(converter: null): CollectionReference<DocumentData>;
```

## Parameters

|  Parameter | Type | Description |
|  --- | --- | --- |
|  converter | null | Converts objects to and from Firestore. |

<b>Returns:</b>

[CollectionReference](./firestore_.collectionreference.md)<!-- -->&lt;[DocumentData](./firestore_.documentdata.md)<!-- -->&gt;

A `CollectionReference<U>` that uses the provided converter.