Skip to main content

Self-hosted Temporal Cluster defaults

Looking for Temporal Cloud defaults?

This page details many of the defaults coded into the Temporal Platform that can produce errors and warnings. Errors are hard limits that fail when reached. Warnings are soft limits that produce a warning log on the server side.

info

These limits might apply specifically to each Workflow Execution and do not pertain to the entire Temporal Platform or individual Namespaces.

  • Identifiers: By default, the maximum length for identifiers (such as Workflow Id, Workflow Type, and Task Queue name) is 1000 characters.
    • This is configurable with the limit.maxIDLength dynamic config variable, set to 255 in this SQL example.
    • The character format is UTF-8.
  • gRPC: gRPC has a limit of 4 MB for each message received.
  • Event batch size: The DefaultTransactionSizeLimit limit is 4 MB. This is the largest transaction size allowed for the persistence of Event Histories.
  • Blob size limit for Payloads (including Workflow context and each Workflow and Activity argument and return value; source):
  • History total size limit (leading to a terminated Workflow Execution):
  • History total count limit (leading to a terminated Workflow Execution):
  • Concurrent limit
    • The following action Commands are limited:
      • ScheduleActivityTask
      • SignalExternalWorkflowExecution
      • RequestCancelExternalWorkflowExecution
      • StartChildWorkflowExecution
    • These will fail if the concurrent pending count exceeds 2,000. For optimal performance, limit concurrent actions to 500 or fewer. This reduces Workflow's Event History size and decreases the loading time in the Web UI.
    • As of v1.21, the open source Temporal Cluster has a default limit of 2,000 pending Activities, Child Workflows, Signals, or Workflow cancellation requests, but you can override the limits in the dynamic configuration using these variables:
      • limit.numPendingActivities.error
      • limit.numPendingSignals.error
      • limit.numPendingCancelRequests.error
      • limit.numPendingChildExecutions.error
    • By default, Batch jobs are limited to one job at a time.
  • Custom Search Attributes limits

For details on dynamic configuration keys, see Dynamic configuration reference.