diff --git a/src/docs/08-workflow-troubleshooting/02-activity-failures.md b/src/docs/08-workflow-troubleshooting/02-activity-failures.md
index 31e044830..4d8ce8fdb 100644
--- a/src/docs/08-workflow-troubleshooting/02-activity-failures.md
+++ b/src/docs/08-workflow-troubleshooting/02-activity-failures.md
@@ -25,3 +25,17 @@ Mitigation: This error is caused by something unexpected within the activity cod
 
 Read more about [error handling](https://cadenceworkflow.io/docs/go-client/error-handling/)
 
+## Blob Size limits
+Description: This is an error caused when a decision contains data that exceeds the configured limit. If an API call contains data that exceeds the limit, the API call will fail. These limits are dynamically configured per cadence domain [link to code](https://github.com/cadence-workflow/cadence/blob/master/common/dynamicconfig/constants.go#L2938).
+
+Mitigation: It is recommended to store the data elsewhere in another storage technology and using its reference. The workflow can then take that reference and pass it around to other parts of the workflow to retrieve that data.
+
+Cadence enforces the maximum blob size in several cases. Some of these are:
+
+- Signal input
+- Workflow input and output
+- Workflow continueAsNew input
+- Activity input and output
+- Workflow/Activity error_details
+- Record marker
+- Heartbeat details
\ No newline at end of file