URL management

URLs identify the location of resources on a website by specifying the domains and paths of the resources. You set the domain part of the URL when you create the site. You set the path part of the URL in the URLs widget, which appears in the content edit pages of an asset.

Types of URLs

You can set the following types of URLs in the URLs widget.

Types of URLs
Type of URL Description
Permalink Permanent link that never expires. Another asset on your site cannot have the same permalink. Do not change permalinks after the initial publishing of content. If you want to change a URL, add an alias to the asset, or add a redirect to the new asset that is replacing the old asset. See Permalinks for additional information.
Alias An alternative link to the asset. You can delete the alias from an asset and use it on another asset.
Redirect (Permanent)

URL from which browsers are permanently redirected. Browsers redirect to the asset with the permalink. For example, if the permalink is /ice-cream-toppings, and you had a link to a previous article /toppings, then you would set /toppings as the redirect URL. Browsers would then redirect from /toppings to /ice-cream-toppings. See Redirect URLs for additional information.

A permanent redirect causes the server to send an HTTP status code 301 to the browser. It also instructs search engines to replace the older permalink in their listings with the permalink.

Redirect (Temporary) Similar to a permanent redirect, a temporary redirect causes the server to send an HTTP status code 307 to the browser. It also instructs search engines to temporarily replace the older URL in their listings with the new permalink. However, the search engines continue to scan the site at the old permalink and will deliver that page after you delete the temporary redirect. See Redirect URLs for additional information.

Publishing to multiple sites

In a multi-site environment, the URLs widget includes a drop-down list option to select a site. Brightspot publishes the asset to the site set in this option using the URL you provide.

../../../_images/urls-multisite-dropdown.png

As shown in the following example, you can publish an asset to multiple sites with the URLs widget. If you set Global, Brightspot publishes to all sites.

../../../_images/urls-multisite-1.png

Publishes to Stargazers site only

../../../_images/urls-multisite-2.png

Publishes to Stargazers and Asteroid Hunters sites

../../../_images/urls-multisite-global.png

Publishes to all sites

When publishing to multiple sites, you can use the same permalink across multiple sites because each site has a different domain name. In the above example, a single permalink is set, /extraterrestrials, for both Asteroid Hunters and Stargazers. The resulting fully qualified URLs are unique because of the sites’ different domain names.

Fully qualified URLs with the same permalinks
Site Fully qualified URL
Asteroid Hunters http://www.asteroidhunters.com/extraterrestrials
Stargazers http://www.stargazers.com/extraterrestrials

Alternatively, you can set site-specific permalinks on an asset. In the following example, there are different permalinks for the site Asteroid Hunters and Stargazers.

../../../_images/urls-widget-multi-permalinks.png
Fully qualified URLs with different permalinks
Site Fully qualified URL
Asteroid Hunters http://www.aseroidhunters.com/extraterrestrials
Stargazers http://www.stargazers.com/outer-space-creatures

Note

An asset that can be published to multiple sites is not automatically accessible in Brightspot to editors working in those sites. For example, in the URLs widget, an asset can have a URL for the Stargazers site, but in the Sites widget, the Stargazers site can be denied access to the asset. For more information, see Assigning permissions to content on multiple sites.

Redirect URLs

Redirects protect against web links that reference obsoleted (moved, deleted or consolidated) content on your site. Redirect URLs map source links to target links, where source links are URLs to obsoleted assets, and target links are URLs to new, replacement assets. Redirects can be either permanent (301 redirects) or temporary (302 or 307 redirects).

You can add redirect URLs in the following ways:

A prerequisite for setting a redirect URL is that the URL itself no longer exist on the obsolete asset. This is accomplished in one of the following ways:

Redirecting to a target vanity URL

You can create vanity redirect URLs, where the target of the redirect is a vanity URL.

To add redirect vanity URLs:

  1. From the Navigation Menu, select Admin > Vanity Redirects.

    The Vanity URL Redirect widget appears, from which you can add new redirects, or search for and edit existing ones.

    ../../../_images/vanity-url1.png
  2. Click New Vanity URL Redirect. The New Vanity URL Redirect widget appears.

  3. Using the table, set the options in the New Vanity URL Redirect widget.

    Field Description
    Name Name describing the purpose of the redirect.
    Local Urls One or more permalinks to obsolete assets. For the permalink values to be saved, you must first remove the permalinks from the obsoleted assets, or delete the assets themselves. Permalinks start with a slash (/) and have no ending slash.
    Destination The vanity URL, reflecting the target page for the redirect.

    Temporary

    If set, the server sends an HTTP 302 temporary redirect to the browser; otherwise, it sends a 301 permanent redirect.

    A temporary redirect instructs search engines to temporarily replace the older URL in their listings with the new one. However, the search engines continue to scan the site at the old URL and will deliver that page after you delete the temporary redirect.

    The following screenshot reflects redirects for a travel site where pages for obsolete vacation packages were removed from the site. Any web links to the removed patagonia, gobidesert, or yukon pages are redirected to the site’s vanity URL, travelcheap.com.

    ../../../_images/vanity-url2.png
  4. Click Save.

    If you get a message about fixing field errors, you probably set a local URL that has not been deleted from the obsolete asset that it references.

Wildcard URLs

Brightspot supports wildcard URLs in cases where you do not want to set a specific URL on an item in the Brightspot editorial UI. In some cases, you may need to work with a Brightspot developer in defining wildcard URLs. Carefully plan your use of wildcard URLs to achieve the desired effect.

A wildcard URL is a partial URL with asterisks, which serve as placeholders for additional path segments that are calculated by the Brightspot backend, or by another application that is integrated with Brightspot. For example, you could set a wildcard URL on a Gallery page, from which users can select and view videos from within the page. When a user selects a particular video, identified by a unique number, Brightspot uses the number to calculate the specific URL of the Gallery page with the embedded video.

A wildcard URL takes one of the following forms: <examplePath>/* or <examplePath>/**

where:

  • <examplePath> is the starting path of the URL, for example, gallery/videos.
  • <examplePath>/* indicates that <examplePath> can be followed by no more than one path segment, for example, /gallery/videos/15.
  • <examplePath>/** indicates that <examplePath> can be followed by multiple path segments, for example, /gallery/videos/hockeyclips/15.

Deleting URLs

To delete a URL:

  1. Search for and open the item in the content edit page.
  2. In the URLs widget, click remove corresponding to the URL that you want to delete.
  3. In the Editorial toolbar, save or publish the item.