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

# Increment Next Identity Operation

> Client language: C#. Also available for [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), [Node.js](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/increment-next-identity.nodejs.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

### Sync

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

using (var session = store.OpenSession())
{ 
  // Pass a collection name that ends with a pipe '|' to create an identity ID
  session.Store(new Company { Name = "RavenDB" }, "companies|");
  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)
var 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"
long incrementedValue = store.Maintenance.Send(nextIdentityOp);

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

using (var session = store.OpenSession())
{ 
  session.Store(new Company { Name = "RavenDB" }, "companies|");
  session.SaveChanges();
  // => Document "companies/3" will be created
}
```

### Async

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

using (var asyncSession = store.OpenAsyncSession())
{ 
  // Pass a collection name that ends with a pipe '|' to create an identity ID
  asyncSession.StoreAsync(new Company { Name = "RavenDB" }, "companies|");
  asyncSession.SaveChangesAsync(); 
  // => 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)
var nextIdentityOp = new NextIdentityForOperation("companies|");

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

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

using (var asyncSession = store.OpenAsyncSession())
{ 
  asyncSession.StoreAsync(new Company { Name = "AnotherCompany" }, "companies|");
  asyncSession.SaveChangesAsync();
  // => Document "companies/3" will be created
}
```

## Syntax

```csharp
public NextIdentityForOperation(string 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.md)
- [Type-specific ID Generation Conventions](https://docs.ravendb.net/6.2/client-api/configuration/identifier-generation/type-specific.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.md)
- [Get identities](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/get-identities.md)
- [Seed identity](https://docs.ravendb.net/6.2/client-api/operations/maintenance/identities/seed-identity.md)
