---
title: "HINCRBY"
url: "https://docs.yugabyte.com/stable/yedis/api/hincrby/"
---

# HINCRBY

## Synopsis

**`HINCRBY key field delta`**

This command adds `delta` to the number that is associated with the given field `field` for the hash `key`. The numeric value must a 64-bit signed integer.

- If the `key` does not exist, a new hash container is created. If the field `field` does not exist in the hash container, the associated string is set to "0".
- If the given `key` is not associated with a hash type, or if the string associated with `field` cannot be converted to an integer, an error is raised.

## Return value

Returns the value after addition.

## Examples

```sh
$ HSET yugahash f1 5
```

```
1
```

```sh
$ HINCRBY yugahash f1 3
```

```
8
```

```sh
$ HINCRBY yugahash non-existent-f2 4
```

```
4
```

```sh
$ HINCRBY non-existent-yugahash f1 3
```

```
3
```

## See also

[`hexists`](/stable/yedis/api/hexists/ "hexists"), [`hget`](/stable/yedis/api/hget/ "hget"), [`hgetall`](/stable/yedis/api/hgetall/ "hgetall"), [`hkeys`](/stable/yedis/api/hkeys/ "hkeys"), [`hlen`](/stable/yedis/api/hlen/ "hlen"), [`hmget`](/stable/yedis/api/hmget/ "hmget"), [`hmset`](/stable/yedis/api/hmset/ "hmset"), [`hset`](/stable/yedis/api/hset/ "hset"), [`hincrby`](/stable/yedis/api/hincrby/ "hincrby"), [`hstrlen`](/stable/yedis/api/hstrlen/ "hstrlen"), [`hvals`](/stable/yedis/api/hvals/ "hvals")