Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions create/redirects.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,10 @@
]
```

This permanently redirects `/source/path` to `/destination/path` so that you don't lose any previous SEO for the original page.

Check warning on line 22 in create/redirects.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

create/redirects.mdx#L22

Spell out 'SEO', if it's unfamiliar to the audience.

### Wildcard paths

To match a wildcard path, use `*` after a parameter. In this example, `/beta/:slug*` matches `/beta/introduction` and redirects it to `/v2/introduction`.

```json
Expand All @@ -32,12 +34,42 @@
]
```

### Partial wildcard patterns

Use partial wildcards to match URL segments that start with a specific prefix. Add `*` at the end of a prefix to match any content that follows.

For example, `/en/articles/9140627-*` matches any path where the segment starts with `9140627-`:

```json
"redirects": [
{
"source": "/en/articles/9140627-*",
"destination": "/collections/overview"
}
]
```

This redirects paths like `/en/articles/9140627-how-do-i-create-collections` and `/en/articles/9140627-what-is-a-collection` to `/collections/overview`.

You can also substitute the captured portion in the destination by using the same partial wildcard pattern:

```json
"redirects": [
{
"source": "/old/article-*",
"destination": "/new/article-*"
}
]
```

This redirects `/old/article-123` to `/new/article-123`, preserving the `123` portion after the prefix.

## Broken links

Catch broken links with our CLI. [Install the CLI](/installation) and run the command:

Check warning on line 69 in create/redirects.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

create/redirects.mdx#L69

Try to avoid using first-person plural like 'our'.

Check warning on line 69 in create/redirects.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

create/redirects.mdx#L69

Use 'command-line tool' instead of 'CLI'.

```bash
mint broken-links
```

The CLI identifies any relative links in your docs that don't exist.

Check warning on line 75 in create/redirects.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

create/redirects.mdx#L75

Use 'command-line tool' instead of 'CLI'.