URL Management

URLs identify the location of resources on a web site 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.

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 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.

Note

In a multi-site environment, you can make an asset accessible to multiple sites, and you can give the asset a different permalink for each site. See Multi-Site and URLs for additional information.

Multi-Site and URLs

In a multi-site environment, the content edit pages include the Sites widget, which provides options for setting the site owner of a content item and for granting other sites access to the asset. Granting access to other sites allows you to publish to multiple sites.

Granting other sites access to an asset also presents the option of using the same permalink for all sites or setting a different permalink for each site. You can use the same permalink for the same asset across multiple sites because each site has a different domain name. The result is a unique fully qualified URL for each site that has access to the asset.

In the following example, the Inspire Leadership site is given access to an asset owned by the Inspire Confidence site. In the URLs widget, a single permalink is set, rising-above-misfortune, which will apply to both sites, Inspire Confidence and Inspire Leadership. However, the resulting fully qualified URLs are unique because of the sites’ different domain names.

Sites Widget URLs Widget
../../../_images/site1.png ../../../_images/urls-widget-one-permalink.png
Fully Qualified URLs with Same Permalinks
Inspire Confidence http://inspireconfidence.brightspot.com/rising-above-misfortune
Inspire Leadership http://inspireleadership.brightspot.com/rising-above-misfortune

Alternatively, you can use the URLs widget to set site-specific permalinks on an asset. In the following example, there are different permalinks for the Inspire Confidence site and for the Inspire Leadership site.

../../../_images/urls-widget-multi-permalinks.png
Fully Qualified URLs with Different Permalinks
Inspire Confidence http://inspireconfidence.brightspot.com/rising-above-misfortune
Inspire Leadership http://inspireleadership.brightspot.com/rising-above-hardship

Note

In order for a site-specific path to work, that site must be given access to the asset; otherwise, the asset is not visible to the site. For information on site ownership and access, see Permissions and Multiple Sites.

Manually Adding URLs

  1. Search for and open the item in the Content Edit Page.

  2. In the URLs widget, click Add URL.

  3. Type the URL in the field. URLs start with a slash (/) and have no ending slash, such as /ice-cream-toppings. To set a wildcard URL, see Wildcard URLs. For details about redirect URLs, see Redirect URLs.

    Set the remaining fields for a single-site or a multiple-site environment.

    Single site Multiple Site
    ../../../_images/urls-widget.png ../../../_images/urls-multisite.png
  4. For a single-site environment, select the type of URL.

    For a multi-site environment:

    1. From the left drop-down list, select the site to which the URL applies. Selecting Global applies the URL to all your sites.
    2. From the right drop-down list, select the type of URL.
  5. Repeat steps 2 to 4 to add additional URLs.

  6. In the Publish Widget, save or publish the item.

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:

Note that 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.

  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.

  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

  1. Search for and open the item in the Content Edit Page.
  2. In the URLs widget, click × corresponding to the URL that you want to delete.
  3. In the Publish Widget, save or publish the item.