Dernière mise à jour:
2 jours, 22 heures ago
When engineers or product managers link to a SUMO support article from inside a product (like Firefox), they should always use a stable URL, not the direct article link. Direct links change when the article title or slug is updated, which can break in-product links. Stable links protect against this and ensure users always reach the right page.
This article explains why stable links matter, how to format them for different platforms, and how to set one up using the Kitsune dashboard.
Table of Contents
Why stable links matter
Using direct links to support articles (like https://support.mozilla.org/en-US/kb/example-article) can lead to problems:
- They break easily: Article URLs change if the title changes unless the editor manually preserves the slug.
- They’re not localizable: Direct links hardcode a language, which isn’t ideal for international users.
- They’re harder to manage: We can't update them globally if used directly in the product.
By contrast, stable links:
- Stay consistent, even if the article URL changes
- Automatically detect the correct locale
- Can be redirected or updated centrally if needed
Link format for in-product support articles
Use a standardized format to construct stable support links for desktop and mobile products:
Notes:
-
%VERSION%,%OS%, and%LOCALE%are automatically populated by the product. - The SUMO team creates the
<slug>and<product>fields. - Replace
<slug>with the unique slug you create.
This format ensures users are directed to the correct localized article.
Example:https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/recommendations-firefox-new-tab
How to setup a stable, in-product link in Kitsune
To create a stable redirect, follow these steps in the Kitsune admin dashboard.
- Sign in to the Kitsune admin dashboard.
- Under INPRODUCT, click Redirects.
- Click in the top-right corner.
- Complete the required fields Product, Topic, and Target, as described in the Redirect fields section below.
- Click .
- Share the completed stable link with the engineer or product manager, using the in-product format:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/<slug>
Redirect fields
| Field | Description |
|---|---|
| Product | Use firefox for desktop or mobile for Firefox mobile products.
|
| Topic (slug) |
Enter a short, unique identifier for the article. This becomes part of the stable link.
Note: The slug does not have to match the target article’s actual URL. Choose something meaningful and consistent for product usage.
|
| Target |
The path to the support article you want to redirect to. Only include the part from Example:
Note: You can include an anchor (e.g.,
kb/customize-items-on-firefox-new-tab-page#w_weather) to link to a specific section. Anchors only work in the English version and may not resolve in other locales. |
Tips
- Stable links ensure localization: users will be automatically redirected to their preferred language when available.
- You can update or delete stable redirects later via the Kitsune admin interface.
- Use this method any time you're linking from:
- “Learn more” in-product messages
- Onboarding flows
- Error or warning messages
- Contextual help modals
