Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
78 lines (56 sloc) 2.01 KB
title lastmod publishdate author draft description tags type
Read a Single Firestore Document
2019-12-04 19:57:21 -0700
2019-12-04 19:57:21 -0700
Jeff Delaney
Strategies for querying a single Firestore document.

The best way to read a single Firestore document depends on the data you have access to. Each of the following strategies will execute a single document read, but uses different methods based on the underlying data model.


With the ID

Reading a document by its ID, path, or reference is simple.

{{< file "js" "firestore.js" >}} {{< highlight javascript >}} async function getDoc(id) { const snapshot = await db.collection('users').doc(id).get(); const data =; }

{{< /highlight >}}

With a Unique Field

A common use case is to fetch a user by their unique email address or username. In this scenario, you may have access to the field value, but not the ID. Make a query, then check it for emptiness.

{{< highlight javascript >}} async function getUserByEmail(email) { // Make the initial query const query = await db.collection('users').where('email', '==', email).get();

if (!result.empty) { const snapshot =[0]; const data =; } else { // not found }

} {{< /highlight >}}

With a Non-Unique Field

Another common use-case is to fetch the most recent post In this case, we order by the desired field, then limit the result set.

{{< highlight javascript >}} async function getMostRecent() { // Make the initial query const query = await db.collection('posts').orderBy('createdAt').limit(1).get();

const snapshot =[0]; const data =;

} {{< /highlight >}}

Learn more about Firestore Data Modeling in the full course.

You can’t perform that action at this time.