# PushOptions.ttl property · @imqueue/job

Source: https://imqueue.org/api/job/latest/job.pushoptions.ttl/
Published: 2026-07-31
Author: @imqueue maintainers (https://github.com/imqueue)
Package: @imqueue/job 3.0.3 — generated reference, not hand-written

Milliseconds after which this job stops being re-scheduled, counted from the moment it is pushed.

**Signature:**

```typescript
ttl?: number;
```

## Remarks

This bounds retrying, not delivery, and the difference is observable. The deadline is only consulted after a handler has run: an expired job is still handed to the handler and still runs, and expiry then suppresses the re-scheduling it would otherwise have got. So a job that keeps failing stops being retried once its TTL has passed, but a job delivered late is not silently discarded — it runs once more first.

Omit it and the job is retried for as long as its handler keeps asking.

