diff --git a/README.md b/README.md
index d3b4045c..300f2284 100644
--- a/README.md
+++ b/README.md
@@ -134,6 +134,30 @@ Datadog.configure { |c| c.ci.agentless_mode_enabled = true }
 
 ## Additional configuration
 
+### Experimental test suite level visibility support
+
+Test suite level visibility (TSLV) is available in experimental mode and disabled by default (yet).
+To enable it add the following line to Datadog configuration:
+
+```ruby
+Datadog.configure do |c|
+  #  ... usual ci configs ...
+  c.ci.experimental_test_suite_level_visibility_enabled = true
+end
+```
+
+This will enable visibility into how your test suites and test sessions behave, providing
+insights about performance and reliability on test suite/session level. Please submit your feedback
+and any issues encountered via Github issues.
+
+Example test suite trace for Ruby project:
+
+![test level visibility trace](./docs/screenshots/tslv-trace.jpeg)
+
+Example test suite level visibility dashboard for a set of Ruby projects:
+
+![test level visibility trace](./docs/screenshots/tslv-dashboard.jpeg)
+
 ### Add tracing instrumentations
 
 It can be useful to have rich tracing information about your tests that includes time spent performing database operations
diff --git a/docs/screenshots/tslv-dashboard.jpeg b/docs/screenshots/tslv-dashboard.jpeg
new file mode 100644
index 00000000..866f4b1c
Binary files /dev/null and b/docs/screenshots/tslv-dashboard.jpeg differ
diff --git a/docs/screenshots/tslv-trace.jpeg b/docs/screenshots/tslv-trace.jpeg
new file mode 100644
index 00000000..f813135d
Binary files /dev/null and b/docs/screenshots/tslv-trace.jpeg differ