Change the URL of an article

Prev Next

Plans supporting changing the URL for an article

Professional
Business
Enterprise






By default, when you create an article, articles will convert the article title into a slug and add it to your knowledge base URL.

For example, if an article title is “This is a really good content,” the resulting URL would be: docs.yourcompany.com/[project version]/docs/this-is-really-good-content.

You can easily change the slug of the article URL inherited from the title, .../this-is-really-good-content.

NOTE

  • Changing an article’s title does not automatically change the article slug.

  • The terms slug and URL are used interchangeably in this article. Both refer to the part of the article link that comes after your site’s domain (e.g., yourdomain.com/what-is-document360)


Changing the slug of an article

You can change the slug of an article in two ways.

Method 1

  1. Navigate to the desired article in the Knowledge base portal.

  2. Click the More() icon in the article header and choose SEO.

    Alternatively, click the More() icon and click More article options.

    The Article settings panel will appear.

  3. In the SEO tab, update the slug in the Slug field.

  4. Click Save.

NOTE

While changing the slug of an article, ensure that you apply the redirection rule to the new slug to avoid broken links. For more information, read the article on Article redirect rule.

Settings for creating an article, including SEO options and tags section.

Method 2:

To update an article’s slug from the editor:

  1. Navigate to the desired article.

  2. If your article is in the Markdown editor, click the article title.

    A panel will appear. In the URL field, update the slug as needed.

    Markdown editor interface showing title, URL, and description fields for content creation.

  3. If your article is in the Advanced WYSIWYG editor, the article title appears at the top of the article content.

    • Click the title and select URL & Description.

    • In the panel that appears, update the slug in the URL field.

  4. Click Update to save the changes.

  5. In the confirmation prompt, choose whether to redirect the old URL to the new slug:

    • Select the checkbox to apply the redirect rule.

    • Deselect the checkbox if you don’t want to set up a redirect.

    • Click Yes.

    Document360 interface showing how to update URL and description in Advanced WYSIYWG editor

NOTE

Redirect Rule: When you change an article's slug, Document360 prompts you to set up a redirect rule. This ensures that links pointing to the old URL remain functional. While optional, it is recommended especially for published articles.


FAQs

What is the default URL format for an article?

The default URL format for an article is based on the article title, converted into a slug. For example, if the article title is 'This is a really good content', the resulting URL would be: docs.yourcompany.com/[project version]/docs/this-is-really-good-content.

Does changing the article title automatically change the slug?

No, changing an article’s title does not automatically change the article slug.

Is it necessary to apply a redirect rule when changing the slug?

While applying a redirect rule is optional, it is recommended to ensure that any links to the old slug remain functional, avoiding broken links.

Why use special characters like ä, ö, ü in URLs?

Special characters like ä, ö, and ü are often part of words in languages such as German. When creating URLs for knowledge base articles or other web content, using these characters can make the URL:

  1. More intuitive: The URL reflects the exact title or content of the article, making it easier for users to understand.

  2. Language-specific: It preserves the linguistic integrity of terms or phrases specific to a language.

  3. SEO-friendly: Search engines can associate the URL more accurately with the content, improving visibility for users searching in that language.

However, due to technical encoding requirements, these characters must be properly percent-encoded to function correctly in web links. Always copy URLs from the portal to ensure they work as expected when shared.

Why do URLs with special characters (e.g., ä, ö, ü) break when shared?

When URLs contain special characters like ä, ö, or ü, they need to be percent-encoded for proper handling in web links. If these characters are not encoded, the URLs may break when shared or accessed, resulting in errors. This behavior is consistent across all browsers and messaging tools.

  1. Copy the URL from the Document360 portal:
    Always copy the URL directly from the portal instead of from the browser's address bar. This ensures that the encoded URL remains intact when shared.

  2. Browser behavior:

    • When you paste the URL in a browser, the percent-encoded characters may be decoded automatically.

    • This is normal behavior and does not impact the functionality if the link is used directly from the portal.

    By copying the link from the portal, the encoded characters remain intact, allowing the link to work as expected when shared with others.

If the issue persists after following these steps, please contact the Document360 support team for further assistance: Contact Document360 Support

Is it possible to change the URL of articles to numbers instead of the title?

Yes, in Document360, you can change an article’s URL to use numbers instead of the title:

  1. Navigate to the desired article.

  2. Click the slug field provided next to the article status badge.

  3. Update the necessary changes in the field provided under URL Slug.

  4. Click Update to save the changes.