diff --git a/src/langsmith/script-delete-traces.mdx b/src/langsmith/script-delete-traces.mdx
index ff40a22db4..e284236bf2 100644
--- a/src/langsmith/script-delete-traces.mdx
+++ b/src/langsmith/script-delete-traces.mdx
@@ -66,3 +66,17 @@ sh delete_trace_by_id.sh "clickhouse://default:password@localhost:8123/default"
 ```
 
 If you visit the LangSmith UI, you should now see all the specified traces have been removed.
+
+## Troubleshooting
+
+### "Could not find trace IDs" error
+
+If you receive an error message stating that trace IDs could not be found, add the `--ssl` flag to your command. Without this flag, the script may not be able to properly connect to ClickHouse, resulting in false "trace ID not found" errors.
+
+Example with SSL flag:
+
+```bash
+sh delete_trace_by_id.sh "clickhouse://default:password@localhost:8123/default" --file path/to/traces.txt --ssl
+```
+
+You can also verify that traces exist by connecting to ClickHouse directly using `clickhouse-cli` and querying for the trace IDs before running the deletion script.