diff --git a/README.md b/README.md
index cbfb71b..7a9d7c5 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,19 @@ This module creates an ECS service with resources neccessary to plug into an App
 * `health_check_unhealthy_threshold` - (default "2") The number of consecutive health check failures required before considering the target unhealthy.
 * `health_check_matcher` - (default "200-299") The HTTP codes to use when checking for a successful response from a target. You can specify multiple values (for example, "200,202") or a range of values (for example, "200-299").
 * `health_check_grace_period_seconds` - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Default 0.
+* `capacity_providers` - (default []) List of capacity providers and the associated weightings
 
 ### Outputs
 
 * `target_group_arn` - the ARN of the target group for use by ALB listener rules (e.g. as a parameter to the [tf_alb_listener_rules module](https://github.com/mergermarket/tf_alb_listener_rules)).
+
+
+### Capacity Providers Example
+```
+[
+    {
+      capacity_provider = "${var.ecs_cluster}-native-scaling"
+      weight            = 1
+    },
+]
+```
\ No newline at end of file