diff --git a/website/content/docs/connect/config-entries/service-router.mdx b/website/content/docs/connect/config-entries/service-router.mdx
index 6a7ba3373..b80bdd6c9 100644
--- a/website/content/docs/connect/config-entries/service-router.mdx
+++ b/website/content/docs/connect/config-entries/service-router.mdx
@@ -8,9 +8,6 @@ description: >-
# Service Router
--> **v1.8.4+:** On Kubernetes, the `ServiceRouter` custom resource is supported in Consul versions 1.8.4+.
-**v1.6.0+:** On other platforms, this config entry is supported in Consul versions 1.6.0+.
-
The `service-router` config entry kind (`ServiceRouter` on Kubernetes) controls Connect traffic routing and
manipulation at networking layer 7 (e.g. HTTP).
@@ -18,6 +15,16 @@ If a router is not explicitly configured or is configured with no routes then
the system behaves as if a router were configured sending all traffic to a
service of the same name.
+## Requirements
+
+- Consul [service mesh connect](/docs/connect/configuration) enabled services
+- Service to service communication over the protocol `http`
+- Consul 1.8.4+ on Kubernetes.
+- Consul 1.5.0+ on other platforms.
+
+-> **v1.8.4+:** On Kubernetes, the `ServiceRouter` custom resource is supported in Consul versions 1.8.4+.
+**v1.6.0+:** On other platforms, this config entry is supported in Consul versions 1.6.0+.
+
## Interaction with other Config Entries
- Service router config entries are a component of [L7 Traffic
@@ -282,6 +289,112 @@ spec:
+### Retry logic
+
+Enable retry logic by delagating this resposbility to Consul and the proxy. Review the [`ServiceRouteDestination`](#serviceroutedestination) block for more details.
+
+
+
+
+```hcl
+Kind = "service-router"
+Name = "orders"
+Routes = [
+ {
+ Match{
+ HTTP {
+ PathPrefix = "/coffees"
+ }
+ }
+
+ Destination {
+ Service = "products"
+ RequestTimeout = "10s"
+ NumRetries = 3
+ RetryOnConnectFailure = true
+ }
+ },
+ {
+ Match{
+ HTTP {
+ PathPrefix = "/orders"
+ }
+ }
+
+ Destination {
+ Service = "procurement"
+ RequestTimeout = "10s"
+ NumRetries = 3
+ RetryOnConnectFailure = true
+ }
+ }
+]
+```
+
+```yaml
+apiVersion: consul.hashicorp.com/v1alpha1
+kind: ServiceRouter
+metadata:
+ name: orders
+spec:
+ routes:
+ - match:
+ http:
+ pathExact: /coffees
+ destination:
+ service: products
+ requestTimeout: 10s
+ numRetries: 3
+ retryOnConnectFailure: true
+ - match:
+ http:
+ pathExact: /orders
+ destination:
+ service: procurement
+ requestTimeout: 10s
+ numRetries: 3
+ retryOnConnectFailure: true
+
+```
+
+
+```json
+{
+ "Kind": "service-router",
+ "Name": "orders",
+ "Routes": [
+ {
+ "Match": {
+ "HTTP": {
+ "PathPrefix": "/coffees"
+ }
+ },
+ "Destination": {
+ "NumRetries": 3,
+ "RequestTimeout": "10s",
+ "RetryOnConnectFailure": true,
+ "Service": "procurement"
+ }
+ },
+ {
+ "Match": {
+ "HTTP": {
+ "PathPrefix": "/orders"
+ }
+ },
+ "Destination": {
+ "NumRetries": 3,
+ "RequestTimeout": "10s",
+ "RetryOnConnectFailure": true,
+ "Service": "procurement"
+ }
+ }
+ ]
+}
+
+```
+
+
## Available Fields