traefik/docs/content/middlewares/replacepath.md

# ReplacePath

Updating the Path Before Forwarding the Request
{: .subtitle }

<!--
TODO: add schema
-->

Replace the path of the request url.

## Configuration Examples

```yaml tab="Docker"
# Replace the path by /foo
labels:
  - "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"
```

```yaml tab="Kubernetes"
# Replace the path by /foo
apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
  name: test-replacepath
spec:
  replacePath:
    path: /foo
```

```yaml tab="Consul Catalog"
# Replace the path by /foo
- "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"
```

```json tab="Marathon"
"labels": {
  "traefik.http.middlewares.test-replacepath.replacepath.path": "/foo"
}
```

```yaml tab="Rancher"
# Replace the path by /foo
labels:
  - "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"
```

```toml tab="File (TOML)"
# Replace the path by /foo
[http.middlewares]
  [http.middlewares.test-replacepath.replacePath]
    path = "/foo"
```

```yaml tab="File (YAML)"
# Replace the path by /foo
http:
  middlewares:
    test-replacepath:
      replacePath:
        path: "/foo"
```

## Configuration Options

### General

The ReplacePath middleware will:

- replace the actual path by the specified one.
- store the original path in a `X-Replaced-Path` header.

### `path`

The `path` option defines the path to use as replacement in the request url.