diff --git a/website/content/docs/api-gateway/usage/errors.mdx b/website/content/docs/api-gateway/usage/errors.mdx
new file mode 100644
index 0000000000..40f1d4011e
--- /dev/null
+++ b/website/content/docs/api-gateway/usage/errors.mdx
@@ -0,0 +1,60 @@
+---
+layout: docs
+page_title: Use Consul API Gateway
+description: >-
+ Learn how to apply a configured Consul API Gateway to your Kubernetes cluster, review the required fields for rerouting HTTP requests, and troubleshoot an error message.
+---
+
+# Error Messages
+
+This topic provides information about potential error messages associated with Consul API Gateway. If you receive an error message that does not appear in this section, refer to the following resources:
+
+* [Common Consul errors](/docs/troubleshoot/common-errors#common-errors-on-kubernetes)
+* [Consul troubleshooting guide](/docs/troubleshoot/common-errors)
+* [Consul Discuss forum](https://discuss.hashicorp.com/)
+
+
+
+## Helm installation failed: "no matches for kind"
+
+```log
+Error: INSTALLATION FAILED: unable to build kubernetes objects from release manifest: [unable to recognize "": no matches for kind "GatewayClass" in version "gateway.networking.k8s.io/v1alpha2", unable to recognize "": no matches for kind "GatewayClassConfig" in version "api-gateway.consul.hashicorp.com/v1alpha1"]
+```
+**Conditions:**
+Consul API Gateway generates this error when the required CRD files have not been installed in Kubernetes prior to installing Consul API Gateway.
+
+**Impact:**
+The installation process typically fails after this error message is generated.
+
+**Resolution:**
+Install the required CRDs. Refer to the [Consul API Gateway installation instructions](/docs/api-gateway/install#installation) for instructions.
\ No newline at end of file
diff --git a/website/content/docs/api-gateway/usage/reroute-http-requests.mdx b/website/content/docs/api-gateway/usage/reroute-http-requests.mdx
new file mode 100644
index 0000000000..8f457e934f
--- /dev/null
+++ b/website/content/docs/api-gateway/usage/reroute-http-requests.mdx
@@ -0,0 +1,58 @@
+---
+layout: docs
+page_title: Reroute HTTP Requests
+description: >-
+ Learn how to configure Consul API Gateway to reroute HTTP requests to a specific path.
+---
+
+# Reroute HTTP Requests
+
+This topic describes how to configure Consul API Gateway to reroute HTTP requests.
+
+## Requirements
+
+1. Verify that the [requirements](/docs/api-gateway/tech-specs) have been met.
+1. Verify that the Consul API Gateway CRDs and controller have been installed and applied. Refer to [Installation](/docs/api-gateway/install) for details.
+
+## Configuration
+
+Configure the following fields in your `Route` configuration to use this feature. Refer to the [Route configuration reference](/docs/api-gateway/configuration/routes) for details about the parameters.
+
+* [`rules.filters.type`](/docs/api-gateway/configuration/routes#rules-filters-type): Set this parameter to `URLRewrite` to instruct Consul API Gateway to rewrite the URL when specific conditions are met.
+* [`rules.filters.urlRewrite`](/docs/api-gateway/configuration/routes#rules-filters-urlrewrite): Specify the `path` configuration.
+* [`rules.filters.urlRewrite.path`](/docs/api-gateway/configuration/routes#rules-filters-urlrewrite-path): Contains the paths that incoming requests should be rewritten to based on the match conditions.
+
+Note that if the route is configured to accept paths with and without a trailing slash, you must make two separate routes to handle each case.
+
+### Example
+
+In the following example, requests to` /incoming-request-prefix/` are forwarded to the `backendRef` as `/prefix-backend-receives/`. A request to `/incoming-request-prefix/request-path`, for instance, is received by the `backendRef` as `/prefix-backend-receives/request-path`.
+
+
+
+```yaml hideClipboard
+apiVersion: gateway.networking.k8s.io/v1beta1
+kind: HTTPRoute
+metadata:
+ name: example-route
+ ##...
+spec:
+ parentRefs:
+ - group: gateway.networking.k8s.io
+ kind: Gateway
+ name: api-gateway
+ rules:
+ - backendRefs:
+ . . .
+ filters:
+ - type: URLRewrite
+ urlRewrite:
+ path:
+ replacePrefixMatch: /prefix-backend-receives/
+ type: ReplacePrefixMatch
+ matches:
+ - path:
+ type: PathPrefix
+ value: /incoming–request-prefix/
+```
+
\ No newline at end of file
diff --git a/website/content/docs/api-gateway/usage/route-to-peered-services.mdx b/website/content/docs/api-gateway/usage/route-to-peered-services.mdx
new file mode 100644
index 0000000000..e00c80e98a
--- /dev/null
+++ b/website/content/docs/api-gateway/usage/route-to-peered-services.mdx
@@ -0,0 +1,18 @@
+---
+Page_title: Route Traffic to Peered Services
+Description: Learn how to configure Consul API Gateway to route traffic to services connected to the mesh through a peering connection.
+---
+
+# Route Traffic to Peered Services
+
+This topic describes how to configure Consul API Gateway to route traffic to services connected to the mesh through a peering connection
+
+## Requirements
+
+1. Verify that the [requirements](/docs/api-gateway/tech-specs) have been met.
+1. Verify that the Consul API Gateway CRDs and controller have been installed and applied. Refer to [Installation](/docs/api-gateway/install) for details.
+
+## Configuration
+
+
+## Example
diff --git a/website/content/docs/api-gateway/usage.mdx b/website/content/docs/api-gateway/usage/usage.mdx
similarity index 55%
rename from website/content/docs/api-gateway/usage.mdx
rename to website/content/docs/api-gateway/usage/usage.mdx
index f5199d0c8f..31b6e78b4b 100644
--- a/website/content/docs/api-gateway/usage.mdx
+++ b/website/content/docs/api-gateway/usage/usage.mdx
@@ -5,17 +5,20 @@ description: >-
Learn how to apply a configured Consul API Gateway to your Kubernetes cluster, review the required fields for rerouting HTTP requests, and troubleshoot an error message.
---
-# Use Consul API Gateway
+# Basic Consul API Gateway Usage
This topic describes how to use Consul API Gateway.
-## Basic usage
+## Requirements
Complete the following steps to use Consul API Gateway in your network.
1. Verify that the [requirements](/docs/api-gateway/tech-specs) have been met.
1. Verify that the Consul API Gateway CRDs and controller have been installed and applied. Refer to [Installation](/docs/api-gateway/install) for details.
-1. Configure your [`Gateway`](/docs/api-gateway/configuration/gateway) and [`Routes`](/docs/api-gateway/configuration/routes) as describe in the [Configuration](/docs/api-gateway/configuration) section.
+
+## Configuration
+
+Configure your [`Gateway`](/docs/api-gateway/configuration/gateway) and [`Routes`](/docs/api-gateway/configuration/routes) as describe in the [Configuration](/docs/api-gateway/configuration) section.
@@ -27,55 +30,14 @@ Complete the following steps to use Consul API Gateway in your network.
-1. Issue the `kubectl apply` command to implement the configurations:
+## Apply configurations
+
+Issue the `kubectl apply` command to implement the configurations:
```shell-session
$ kubectl apply -f gateway.yaml routes.yaml
```
-## Reroute HTTP requests
-
-Configure the following fields in your `Route` configuration to use this feature. Refer to the [Route configuration reference](/docs/api-gateway/configuration/routes) for details about the parameters.
-
-* [`rules.filters.type`](/docs/api-gateway/configuration/routes#rules-filters-type): Set this parameter to `URLRewrite` to instruct Consul API Gateway to rewrite the URL when specific conditions are met.
-* [`rules.filters.urlRewrite`](/docs/api-gateway/configuration/routes#rules-filters-urlrewrite): Specify the `path` configuration.
-* [`rules.filters.urlRewrite.path`](/docs/api-gateway/configuration/routes#rules-filters-urlrewrite-path): Contains the paths that incoming requests should be rewritten to based on the match conditions.
-
-Note that if the route is configured to accept paths with and without a trailing slash, you must make two separate routes to handle each case.
-
-### Example
-
-In the following example, requests to` /incoming-request-prefix/` are forwarded to the `backendRef` as `/prefix-backend-receives/`. A request to `/incoming-request-prefix/request-path`, for instance, is received by the `backendRef` as `/prefix-backend-receives/request-path`.
-
-
-
-```yaml hideClipboard
-apiVersion: gateway.networking.k8s.io/v1beta1
-kind: HTTPRoute
-metadata:
- name: example-route
- ##...
-spec:
- parentRefs:
- - group: gateway.networking.k8s.io
- kind: Gateway
- name: api-gateway
- rules:
- - backendRefs:
- . . .
- filters:
- - type: URLRewrite
- urlRewrite:
- path:
- replacePrefixMatch: /prefix-backend-receives/
- type: ReplacePrefixMatch
- matches:
- - path:
- type: PathPrefix
- value: /incoming–request-prefix/
-```
-
-
-## Error Messages
-This topic provides information about potential error messages associated with Consul API Gateway. If you receive an error message that does not appear in this section, refer to the following resources:
-
-* [Common Consul errors](/docs/troubleshoot/common-errors#common-errors-on-kubernetes)
-* [Consul troubleshooting guide](/docs/troubleshoot/common-errors)
-* [Consul Discuss forum](https://discuss.hashicorp.com/)
-
-
-
-### Helm installation failed: "no matches for kind"
-
-```log
-Error: INSTALLATION FAILED: unable to build kubernetes objects from release manifest: [unable to recognize "": no matches for kind "GatewayClass" in version "gateway.networking.k8s.io/v1alpha2", unable to recognize "": no matches for kind "GatewayClassConfig" in version "api-gateway.consul.hashicorp.com/v1alpha1"]
-```
-**Conditions:**
-Consul API Gateway generates this error when the required CRD files have not been installed in Kubernetes prior to installing Consul API Gateway.
-
-**Impact:**
-The installation process typically fails after this error message is generated.
-
-**Recommended Action:**
-Install the required CRDs by using the command in Step 1 of the [Consul API Gateway installation instructions](/docs/api-gateway/install#installation) and then retry installing Consul API Gateway.
diff --git a/website/data/docs-nav-data.json b/website/data/docs-nav-data.json
index 1a06f9cd96..16cdb531dc 100644
--- a/website/data/docs-nav-data.json
+++ b/website/data/docs-nav-data.json
@@ -1276,7 +1276,25 @@
},
{
"title": "Usage",
- "path": "api-gateway/usage"
+ "routes": [
+ {
+ "title": "Basic Usage",
+ "path": "api-gateway/usage/usage"
+ },
+ {
+ "title": "Reroute HTTP Requests",
+ "path": "api-gateway/usage/reroute-http-requests"
+ },
+ {
+ "title": "Route Traffic to Peered Services",
+ "path": "api-gateway/usage/route-to-peered-services"
+ },
+ {
+ "title": "Error Messages",
+ "path": "api-gateway/usage/errors"
+ }
+
+ ]
},
{
"title": "Configuration",