diff --git a/python_modules/dagster/dagster/_core/definitions/metadata/__init__.py b/python_modules/dagster/dagster/_core/definitions/metadata/__init__.py
index 275512ded3f08..6ade9835c5b18 100644
--- a/python_modules/dagster/dagster/_core/definitions/metadata/__init__.py
+++ b/python_modules/dagster/dagster/_core/definitions/metadata/__init__.py
@@ -920,6 +920,19 @@ class TableMetadataValue(
     Args:
         records (TableRecord): The data as a list of records (i.e. rows).
         schema (Optional[TableSchema]): A schema for the table.
+
+    Example:
+        .. code-block:: python
+
+            from dagster import TableMetadataValue, TableRecord
+
+            TableMetadataValue(
+                schema=None,
+                records=[
+                    TableRecord({"column1": 5, "column2": "x"}),
+                    TableRecord({"column1": 7, "column2": "y"}),
+                ]
+            )
     """
 
     @public