# DurableMessagingOptions Properties

[Type overview](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/)

## DeadLetterRetentionPeriod {#deadletterretentionperiod-79c165b3}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/deadletterretentionperiod-79c165b3/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public TimeSpan DeadLetterRetentionPeriod
```

Gets or sets how long inbox and outbox dead letters are retained.

## DeduplicationWindow {#deduplicationwindow-850f3f43}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/deduplicationwindow-850f3f43/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public TimeSpan DeduplicationWindow
```

Gets or sets how long after a message's send time the receiving inbox retains its processed record and admits deliveries of it. A tracked processed message is answered with [DeliveryResult](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.deliveryresult/), or, when an inbox sink rejected it on delivery, with the same [DeadLettered](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.deliveryresult.deadlettered/) reason and code.

### Value

The deduplication window. Must be greater than [DurableMessagingOptions](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/). Defaults to 7 days.

## InboxBatchSize {#inboxbatchsize-81db195b}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/inboxbatchsize-81db195b/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public int InboxBatchSize
```

Gets or sets the maximum number of inbox messages processed by one messaging pump pass.

## InboxRetryTimeout {#inboxretrytimeout-da8a0333}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/inboxretrytimeout-da8a0333/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public TimeSpan InboxRetryTimeout
```

Gets or sets how long the inbox retries a message whose handler attempts throw before the message is dead-lettered.

### Value

Must be greater than or equal to `System.TimeSpan.Zero`, which dead-letters a message at its second failure: recovery can't tell a failed attempt from one which a crash interrupted before it ran. Defaults to 6 hours.

## MaxCapacity {#maxcapacity-1ff9d43c}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/maxcapacity-1ff9d43c/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public int MaxCapacity
```

Gets or sets the maximum number of pending inbox messages. When this limit is reached, new deliveries return [Backpressured](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.deliveryresult.backpressured/).

### Value

The maximum inbox capacity. Must be greater than zero. Defaults to 1000.

## MaxRetainedDeadLetters {#maxretaineddeadletters-c3c92187}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/maxretaineddeadletters-c3c92187/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public int MaxRetainedDeadLetters
```

Gets or sets the maximum number of dead letters retained per inbox and per outbox.

## OutboxBatchSize {#outboxbatchsize-09256bb8}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/outboxbatchsize-09256bb8/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public int OutboxBatchSize
```

Gets or sets the maximum number of outbox delivery attempts in flight for one grain.

## OutboxRetryTimeout {#outboxretrytimeout-a6d1ca8e}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/outboxretrytimeout-a6d1ca8e/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public TimeSpan OutboxRetryTimeout
```

Gets or sets how long after a message's send time the outbox attempts delivery before it dead-letters the message, including while the receiver is backpressured or reports no inbox handler.

### Value

Must be greater than zero and less than [DurableMessagingOptions](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/), so the retry budget ends within the receiver's retention window. Defaults to 6 hours.

## RetryInitialInterval {#retryinitialinterval-bb7c30ad}

[Dedicated page](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.configuration.durablemessagingoptions/properties/retryinitialinterval-bb7c30ad/)

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/Configuration/DurableMessagingOptions.cs)

```csharp
public TimeSpan RetryInitialInterval
```

Gets or sets the delay before the first retry of a failed outbox delivery or inbox processing attempt.

### Value

The initial retry interval. Must be greater than zero. Defaults to 1 second.
