Skip to content

docs: fix inaccuracies in blob size limit error page#4384

Closed
lennessyy wants to merge 8 commits intomainfrom
fix/blob-size-limit-error-accuracy
Closed

docs: fix inaccuracies in blob size limit error page#4384
lennessyy wants to merge 8 commits intomainfrom
fix/blob-size-limit-error-accuracy

Conversation

@lennessyy
Copy link
Copy Markdown
Contributor

@lennessyy lennessyy commented Apr 2, 2026

Summary

  • Restructures the page into two clear sections: Payload size limit (2 MB per payload) and gRPC message size limit (4 MB per message)
  • Fixes incorrect claim that gRPC oversized response terminates the Workflow — it actually causes an infinite retry loop
  • Adds documentation for the misleading StartToCloseTimeout symptom when Activity results exceed the gRPC limit
  • Removes code-formatted BlobSizeLimitError from the opening since it's not a literal error message users would see
  • Adds example error messages for both limit types

Test plan

  • Verify page renders correctly
  • Review error messages with eng for accuracy

🤖 Generated with Claude Code

┆Attachments: EDU-6154 docs: fix inaccuracies in blob size limit error page

Restructure into two sections for the two distinct limits:
- Payload size limit (2 MB per payload, server-side)
- gRPC message size limit (4 MB per message, transport-level)

Fix incorrect claim that gRPC oversized response terminates the
Workflow — it actually causes an infinite retry loop. Add
documentation for the misleading StartToCloseTimeout symptom
when Activity results exceed the gRPC limit.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lennessyy lennessyy requested a review from a team as a code owner April 2, 2026 22:30
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Error Error Apr 3, 2026 8:15pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

📖 Docs PR preview links

lennessyy and others added 2 commits April 2, 2026 15:33
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---

The `BlobSizeLimitError` is an error that occurs when the size of a blob (payloads including Workflow context and each Workflow and Activity argument and return value) exceeds the set limit in Temporal.
Temporal enforces size limits on the data that passes between the Temporal Client, Workers, and the Temporal Service. There are two distinct limits: a 2 MB limit on individual Payloads enforced by the Temporal Service, and a 4 MB limit on entire gRPC messages enforced by the transport layer. Each produces different error messages and behaviors.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Temporal enforces size limits on the data that passes between the Temporal Client, Workers, and the Temporal Service. There are two distinct limits: a 2 MB limit on individual Payloads enforced by the Temporal Service, and a 4 MB limit on entire gRPC messages enforced by the transport layer. Each produces different error messages and behaviors.
Temporal enforces size limits on the data that passes between the Temporal Client, Workers, and the Temporal Service. There are two distinct limits: a 2 MB limit on individual Payloads enforced by the Temporal Service, and a 4 MB limit on entire gRPC messages enforced by the transport layer. Each produces different error messages and behaviors, and requires different solutions.

lennessyy and others added 2 commits April 2, 2026 15:48
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lennessyy
Copy link
Copy Markdown
Contributor Author

Superseded by #4379, which now contains all these changes.

@lennessyy lennessyy closed this Apr 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant