---
title: "Increment Next Identity Operation"
url: "https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/increment-next-identity"
version: "6.2"
language: "nodejs"
---

# Increment Next Identity Operation

> Client language: Node.js. Also available for [C#](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/increment-next-identity.md), [Python](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/increment-next-identity.python.md), [PHP](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/increment-next-identity.php.md).
>
> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

> **Note**
>
> - Use `NextIdentityForOperation` to increment the latest identity value set on the server for the specified collection in the database.
>
> - The next document that will be created using an identity for the collection will receive the consecutive integer value.
>
> - In this page:
>
>   - [Increment the next identity value](#increment-the-next-identity-value)
>   - [Syntax](#syntax)

## Increment the next identity value

```javascript
// Create a document with an identity ID:
// ======================================

const session = documentStore.openSession();
const company = new Company();
company.name = "RavenDB";

// Pass a collection name that ends with a pipe '|' to create an identity ID
await session.store(company, "companies|");

await session.saveChanges();
// => Document "companies/1" will be created 

// Increment the identity value on the server:
// ===========================================

// Define the next identity operation
// Pass the collection name (can be with or without a pipe)
const nextIdentityOp = new NextIdentityForOperation("companies|");

// Execute the operation by passing it to maintenance.send
// The latest value will be incremented to "2"
// and the next document created with an identity will be assigned "3"
const incrementedValue = await store.maintenance.send(nextIdentityOp);

// Create another document with an identity ID:
// ============================================

const company = new Company();
company.name = "AnotherComapany";

await session.store(company, "companies|");
await session.saveChanges();
// => Document "companies/3" will be created
```

## Syntax

```javascript
const nextIdentityOp = new NextIdentityForOperation(name);
```

| Parameter | Type | Description |
| - | - | - |
| **name** | string | The collection name for which to increment the identity value.<br />Can be with or without a pipe in the end (e.g. "companies" or "companies\|". |

## See also

- [Working with Document Identifiers](https://docs.ravendb.net/6.2/client-api/document-identifiers/working-with-document-identifiers.md)
- [Global ID Generation Conventions](https://docs.ravendb.net/6.2/client-api/configuration/identifier-generation/global.nodejs.md)
- [Type-specific ID Generation Conventions](https://docs.ravendb.net/6.2/client-api/configuration/identifier-generation/type-specific.nodejs.md)
- [Document Identifier Generation](https://docs.ravendb.net/6.2/server/kb/document-identifier-generation.md)
- [What are operations](https://docs.ravendb.net/6.2/client-api/operations/what-are-operations.nodejs.md)
- [Get identities](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/get-identities.nodejs.md)
- [Seed identity](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/seed-identity.nodejs.md)
