Increment operations in Firebase - Commands & Configuration

Introduction

Increment operations let you add a number to a value stored in your Firebase database without reading it first. This helps keep your data accurate and avoids conflicts when many users update the same value at once.

When you want to count how many times a button is clicked by different users.

When you need to update a score in a game without losing other players' updates.

When tracking the number of views on a post in real time.

When you want to add points to a user's profile safely without reading the current points first.

When multiple devices update the same counter and you want to avoid errors.

Commands

This command increases the 'score' field by 1 for the user with ID 'user123' in the 'users' collection. It updates the value safely without reading it first.

Terminal

firebase firestore:update --project example-project --collection users --doc user123 --field score=increment(1)

Expected Output

Updated document user123 in collection users with increment operation on field score.

→

--project - Specifies the Firebase project to use.

→

--collection - Specifies the Firestore collection containing the document.

→

--doc - Specifies the document ID to update.

→

--field - Specifies the field and increment operation to apply.

This command retrieves the updated document to verify the increment operation was successful.

Terminal

firebase firestore:get --project example-project --collection users --doc user123

Expected Output

{

  "name": "user123",

  "score": 5

}

→

--project - Specifies the Firebase project to use.

→

--collection - Specifies the Firestore collection containing the document.

→

--doc - Specifies the document ID to retrieve.

Key Concept

If you remember nothing else from this pattern, remember: increment operations update numeric fields safely without reading them first, preventing conflicts.

Common Mistakes

Trying to increment a field that does not exist yet.

The increment operation requires the field to be a number or it will fail.

Initialize the field with a number (like 0) before using increment operations.

Using increment operation on a non-numeric field like a string.

Increment only works on numeric fields and will cause an error otherwise.

Ensure the field is numeric before applying increment.

Reading the value first and then writing the incremented value manually.

This can cause race conditions and lost updates when multiple users write at the same time.

Use the atomic increment operation provided by Firebase to avoid conflicts.

Summary

Use Firebase increment operations to safely add numbers to fields without reading them first.

Run update commands with increment to avoid conflicts from multiple users updating the same field.

Verify updates by retrieving the document after the increment operation.