diff --git a/temporalio/contrib/langsmith/README.md b/temporalio/contrib/langsmith/README.md
index 7002f5538..421a76c02 100644
--- a/temporalio/contrib/langsmith/README.md
+++ b/temporalio/contrib/langsmith/README.md
@@ -1,5 +1,7 @@
 # LangSmith Plugin for Temporal Python SDK
 
+> ⚠️ **This package is currently at an experimental release stage.** ⚠️
+
 This Temporal [Plugin](https://docs.temporal.io/develop/plugins-guide) allows your [LangSmith](https://smith.langchain.com/) traces to work within Temporal Workflows. It propagates trace context across Worker boundaries so that `@traceable` calls, LLM invocations, and Temporal operations show up in a single connected trace, and ensures that replaying does not generate duplicate traces.
 
 ## Quick Start
diff --git a/temporalio/contrib/langsmith/__init__.py b/temporalio/contrib/langsmith/__init__.py
index 465e36c19..c174fe92b 100644
--- a/temporalio/contrib/langsmith/__init__.py
+++ b/temporalio/contrib/langsmith/__init__.py
@@ -1,5 +1,9 @@
 """LangSmith integration for Temporal SDK.
 
+.. warning::
+    This package is experimental and may change in future versions.
+    Use with caution in production environments.
+
 This package provides LangSmith tracing integration for Temporal workflows,
 activities, and other operations. It includes automatic run creation and
 context propagation for distributed tracing in LangSmith.
diff --git a/temporalio/contrib/langsmith/_interceptor.py b/temporalio/contrib/langsmith/_interceptor.py
index 5e020eb4d..6789ddea4 100644
--- a/temporalio/contrib/langsmith/_interceptor.py
+++ b/temporalio/contrib/langsmith/_interceptor.py
@@ -533,6 +533,10 @@ class LangSmithInterceptor(
 ):
     """Interceptor that supports client and worker LangSmith run creation
     and context propagation.
+
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
     """
 
     def __init__(
diff --git a/temporalio/contrib/langsmith/_plugin.py b/temporalio/contrib/langsmith/_plugin.py
index d7a45a130..6e9fba0ee 100644
--- a/temporalio/contrib/langsmith/_plugin.py
+++ b/temporalio/contrib/langsmith/_plugin.py
@@ -18,6 +18,10 @@
 class LangSmithPlugin(SimplePlugin):
     """LangSmith tracing plugin for Temporal SDK.
 
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
+
     Provides automatic LangSmith run creation for workflows, activities,
     and other Temporal operations with context propagation.
     """