Brightspot CMS User Guide

Changing an asset's permalink


When you initially publish an asset, Brightspot typically assigns it a URL based on your current site and the asset's slug. (The slug is an identifier based on the asset's headline or title.) That URL is the asset's permalink. Brightspot assumes that once an asset is published, visitors or search engines cache that permalink; arbitrarily changing an asset's permalink can cause an Error 404, and the visitor may incorrectly think the asset is no longer available.

If you change the asset's headline, the path portion of the URL may be inconsistent or even conflict with each other. In such cases, you may want to manually change the permalink to the new slug, and redirect from the old URL to the new one.

Inconsistent path and headline Inconsistent path and headline
Inconsistent path and headline

Referring to the previous illustration, the permalink's current path is /common-cms-mistakes, implying that the asset's original headline was Common CMS mistakes. An editor subsequently changed the headline to CMS best practices, and Brightspot recommends a new slug cms-best-practices. At this point, a visitor clicking on an old bookmark with /common-cms-mistakes sees the revised asset CMS best practices and may conclude there is a mistake. As a best practice, the editor should also update the permalink, and configure a redirect from the old permalink to the new one.

To change an asset's permalink:

  1. Search for an open the asset whose permalink you want to change.
  2. In the URLs widget, from the dropdown list underneath the permalink, select Redirect (Permanent) or Redirect (Temporary). (For an explanation of the difference between permanent and temporary redirects, see Asset URLs.)
  3. Click add_circle_outline Add.
  4. In the text field, enter a slash (/) and then a new slug. The new slug must not already be assigned to an existing asset in the same site.
  5. From the drop-down list, select Permalink.
    Changing a permalink Changing a permalink
    Changing a permalink
  6. Complete your site's workflow and publish the asset.
Previous Topic
Uses of redirects
Next Topic
Adding vanity redirect URLs
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Modules
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Shopify
Apple News