Site URLs

Overview

A URL is an address that you type in your browser’s address bar, and every item you publish in Brightspot has its own, unique URL. The base portion of a URL typically starts with http:// or https:// followed by a domain name. The following table describes the different types of base URLs you can assign to each of your sites:

Type of Base URL Description
Site URL Base portion of a URL a visitor uses to retrieve one of your published items.
Preview URL Base portion of a URL used to preview content when using a headless environment.
Tool URL Base portion of a URL that editors use to log in to Brightspot.

For example, Sally is a voracious reader and an even more voracious writer. She was hired by Extraterrestrial Cuisine, a media giant that has three publications: Moon Munchies, Venus Victuals, and Martian Menus, and Sally is publishing content to all three. The following table shows how Extraterrestrial Cuisine has set up its domain names:

Site Base URL Type
Brightspot http://editors.extraterrestrial.com Tool URL
Moon Munchies http://www.moonmunchies.com Site URL
Venus Victuals http://www.venusvictuals.com Site URL
Martian Menus http://www.martianmenus.com Site URL

When Sally comes to work every morning, she logs in to Brightspot using the address http://editors.extraterrestrial.com. Whenever she works on an article, she sees URLs similar to the following in her browser—regardless to which site she is publishing content.

../../../_images/tool-url1.svg

Visitors who want to read one of her articles see a URL similar to the following in their browsers.

../../../_images/site-url.svg

Configuring Base URLs

The following table describes when you need to configure base URLs for your sites as well as associated default values.

Type of Base URL When to Set Default if Not Set
Site URL As needed; as a best practice, assign a different Site URL to each of your sites.
  • For the Global site, same domain as where you installed Brightspot.
  • For other sites, same as Global site.
Preview URL You are using Brightspot in a headless environment. Available for the Global site only. N/A
Tool URL

If both of the following conditions are true:

  • Your Brightspot developer did not configure a tool URL as described in Tool URL.
  • Brightspot is sending notifications with links (such as text messages or emails).

Otherwise, configuring a Tool URL is optional.

Same as Site URL.
  1. From the Navigation Menu, select Admin > Sites & Settings.

  2. In the Sites & Settings widget, click the site for which you want to configure base URLs. The Edit Global or Edit Site widget appears.

  3. Click Main, and enter base URLs in the Default Tool URL field.

    ../../../_images/base-urls.png
  4. Click Save.

See also: