Document ID strategies in Firebase - Commands & Configuration

Introduction

When you store data in Firebase Firestore, each piece of data is saved as a document with a unique ID. Choosing how to create these IDs helps keep your data organized and easy to find.

When you want Firebase to create a unique ID automatically for each new document.

When you want to use a meaningful ID like a username or email to find documents easily.

When you want to avoid duplicate documents by using a fixed ID for each entry.

When you want to group related data by using IDs that follow a pattern.

When you want to keep document IDs short and simple for quick access.

Commands

This command adds a new document to the 'users' collection with an automatically generated unique ID.

Terminal

firebase firestore:documents:add users --data '{"name":"Alice","age":30}'

Expected Output

Document added with ID: XyZ123AbC

This command creates or updates a document with the fixed ID 'alice123' in the 'users' collection.

Terminal

firebase firestore:documents:set users/alice123 --data '{"name":"Alice","age":30}'

Expected Output

Document users/alice123 created or updated.

This command retrieves the document with the ID 'alice123' from the 'users' collection to verify it exists.

Terminal

firebase firestore:documents:get users/alice123

Expected Output

{

  "name": "Alice",

  "age": 30

}

Key Concept

If you remember nothing else from this pattern, remember: choosing the right document ID helps you find and manage your data easily and prevents duplicates.

Common Mistakes

Using random IDs when you need to find documents by a known key.

It makes it hard to locate or update specific documents later.

Use meaningful fixed IDs like usernames or emails when you want easy access.

Manually creating IDs that are not unique.

This causes data to overwrite or conflicts in your database.

Use Firebase's automatic ID generation or ensure your custom IDs are unique.

Summary

Use Firebase's automatic ID generation for unique, random document IDs.

Use fixed, meaningful IDs when you want to find or update documents easily.

Always verify document creation by retrieving the document after adding or updating.