diff --git a/docs/reference/index.md b/docs/reference/index.md
index e92d5fff1..df1c5bf30 100644
--- a/docs/reference/index.md
+++ b/docs/reference/index.md
@@ -32,3 +32,6 @@ More detailed information on how the Agent works can be found in the [advanced t
 
 APM Agents work in conjunction with the [APM Server](docs-content://solutions/observability/apm/index.md), [Elasticsearch](docs-content://get-started/introduction.md#what-is-es), and [Kibana](docs-content://get-started/introduction.md#what-is-kib). The [APM documentation](docs-content://solutions/observability/apm/index.md) provides details on how these components work together, and provides a matrix outlining [Agent and Server compatibility](docs-content://solutions/observability/apm/apm-agent-compatibility.md).
 
+## Troubleshooting
+
+If you're experiencing issues with the APM Python agent, refer to [Troubleshoot APM Python Agent](docs-content://troubleshoot/observability/apm-agent-python/apm-python-agent.md).
\ No newline at end of file
diff --git a/docs/reference/toc.yml b/docs/reference/toc.yml
index 9d4df720a..1cd287df6 100644
--- a/docs/reference/toc.yml
+++ b/docs/reference/toc.yml
@@ -30,4 +30,6 @@ toc:
     children:
       - file: upgrading-6-x.md
       - file: upgrading-5-x.md
-      - file: upgrading-4-x.md
\ No newline at end of file
+      - file: upgrading-4-x.md
+  - title: Troubleshooting
+    crosslink: docs-content://troubleshoot/observability/apm-agent-python/apm-python-agent.md
\ No newline at end of file