Redis HINCRBY in Golang (Detailed Guide w/ Code Examples)

Use Case(s)

The HINCRBY command in Redis is used to increment the integer value of a hash field by the given number. Common use cases include:

  • Counter functionality in web applications, such as likes, shares, views, or upvotes.
  • Real-time analytics where you need to increment values in a high-speed and concurrent environment.

Code Examples

The Go application needs the go-redis package for connecting to and interacting with Redis. Run go get to install it.

Here's an example code snippet where we're using HIncrBy method of Redis client to increment a hash field:

package main import ( "" "context" ) var ctx = context.Background() func main() { rdb := redis.NewClient(&redis.Options{ Addr: "localhost:6379", // replace with your Redis instance address Password: "", // replace with your password if any DB: 0, // replace with your database number }) err := rdb.HIncrBy(ctx, "hash-key", "field", 1).Err() if err != nil { panic(err) } }

In this example, we connect to a local Redis instance and increment a field named field under the hash hash-key by 1.

Best Practices

  • Check for errors while performing operations with Redis. This helps in handling exceptions and avoiding potential crashes.
  • Use the Redis connection pool provided by go-redis package for efficiently managing connections in a concurrent environment.

Common Mistakes

  • Not verifying whether the field in the hash actually holds an integer value. The HINCRBY command works only on integer fields.
  • Using HIncrBy operations on non-existing keys will not result in an error but creates that key with the increment amount as its value. Hence, ensure you're working with desired keys.


Q: Can I use a negative number with HINCRBY? A: Yes, using a negative number with HINCRBY effectively decrements the field's value.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.