From fbbea806852f95557cb55d06ea306e923676bc70 Mon Sep 17 00:00:00 2001
From: AKSHAYA <76612327+akshayamadhuri@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:17:57 +0530
Subject: [PATCH] Updated LangSmith setup instructions  (#3933)

Co-authored-by: Kartik Balasubramanian <22399046+HumanistSerif@users.noreply.github.com>
---
 docs/advanced-ai/langchain/langsmith.md | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/docs/advanced-ai/langchain/langsmith.md b/docs/advanced-ai/langchain/langsmith.md
index 04230056e..d7bc48f1f 100644
--- a/docs/advanced-ai/langchain/langsmith.md
+++ b/docs/advanced-ai/langchain/langsmith.md
@@ -15,15 +15,28 @@ Self-hosted n8n only.
 ## Connect your n8n instance to LangSmith
 
 1. [Log in to LangSmith](https://smith.langchain.com/settings) and get your API key.
+
 1. Set the LangSmith environment variables:
 
-	| Variable | Value |
-	| -------- | ----- |
-	| LANGCHAIN_ENDPOINT | `"https://api.smith.langchain.com"` |
-	| LANGCHAIN_TRACING_V2 | `true` |
-	| LANGCHAIN_API_KEY | Set this to your API key |
+   | Variable                        | Value |
+   | ------------------------------- | ----- |
+   | `LANGCHAIN_ENDPOINT`            | `"https://api.smith.langchain.com"` |
+   | `LANGCHAIN_TRACING_V2`          | `true` |
+   | `LANGCHAIN_API_KEY`             | Set this to your API key |
+   | `LANGCHAIN_PROJECT`             | Optional project name (defaults to `"default"`) |
+   | `LANGCHAIN_CALLBACKS_BACKGROUND` | `true` (asynchronous trace upload) |
 
-	Set the variables so that they're available globally in the environment where you host your n8n instance. You can do this in the same way as the rest of your general configuration.
+   /// note
+   If you just created your LangSmith account, you will see a project named **"default"** only after the first trace is sent from n8n.  
+   All traces go to this project unless you set `LANGCHAIN_PROJECT` to a different name.
+   ///
+
+   /// note
+   Traces may appear with a short delay because `LANGCHAIN_CALLBACKS_BACKGROUND` defaults to asynchronous submission.  
+   Set it to `false` if you prefer synchronous uploads for debugging.
+   ///
+
+   Set the variables so that they're available globally in the environment where you host your n8n instance. You can do this in the same way as the rest of your general configuration.
 
 1. Restart n8n.