diff --git a/docs/sharding-espresso.md b/docs/sharding-espresso.md
index 14b5d69b..b60c3f82 100644
--- a/docs/sharding-espresso.md
+++ b/docs/sharding-espresso.md
@@ -302,8 +302,24 @@ filters:
values: ["com.lambdatest.proverbial"]
```
+
This example will fetch all the test cases from 2 classes and 1 package as defined above and divide them with respect to concurrency given in the yaml file.
+## Annotations in Sharding
+
+You can also filter your Espresso tests based on annotations while using sharding. This helps you execute only the test cases marked with specific annotations.
+
+```yaml
+filters:
+ attributes:
+ - type: annotation
+ values: ["com.lambdatest.proverbial.demo1", "com.lambdatest.proverbial.demo2"]
+```
+
+:::info
+This configuration will run tests annotated with multiple annotations, i.e., only the intersection of all mentioned annotations will be considered.
+:::
+
## Generate Reports and Artifacts
To generate artifacts for your Espresso tests, add the `artifacts: true`, and `report: true` flag in your YAML file:
diff --git a/docs/speedup-espresso.md b/docs/speedup-espresso.md
index b0ef25a1..fab08cd8 100644
--- a/docs/speedup-espresso.md
+++ b/docs/speedup-espresso.md
@@ -172,18 +172,22 @@ Please refer to the example `cURL` requests given below for your reference.