diff --git a/docs/automations/docs-propagation.md b/docs/automations/docs-propagation.md
index e8eba08d3640e8..44027b4d123b50 100644
--- a/docs/automations/docs-propagation.md
+++ b/docs/automations/docs-propagation.md
@@ -125,4 +125,15 @@ used to propagate the description.
 
 <p align="left">
   <img width="50%"  src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/automation/oss/docs-propagation/view-propagated-docs.png"/>
-</p>
\ No newline at end of file
+</p>
+
+## Troubleshooting Documentation Propagation Issues
+
+If you encounter issues with documentation propagation, consider the following steps:
+
+1. **Verify Propagation Settings**: Ensure that the feature is enabled as described above.
+2. **Check Lineage Configuration**: Use the DataHub UI to verify column-level lineage connections.
+3. **Review Ingestion Logs**: Check logs for any errors or warnings related to metadata propagation.
+4. **Manual Verification**: Inspect the DataHub UI or use the DataHub Python SDK to verify column descriptions.
+
+For more advanced scenarios, consider reviewing the source code or using the action framework for custom propagation logic.
\ No newline at end of file