Support and Documentation

How to make a site
  1. From the Navigation Menu, expand Admin, and select Sites & Settings.

  2. In the Sites widget, click New Site. The New Site widget appears.

  3. Using the following tables as a reference, enter values for the site.

  4. Click Save.

The following tables describes the settings available for a site. (Your version of Brightspot may have different settings.)

Table 90. Main tab

Field

Description

Name

Name of the site. When a user switches to this site, its name appears in the header. The name also appears in various widgets.

SEO Display Name

Appends this value in the <title> tag, after the item's title. For example, if you have a recipe Sugar Cookies with Sugar Glaze, and in this field you add Give Me Glucose, the title tag is <title>Sugar Cookies with Sugar Glaze - Give Me Glucose</title>. Because the <title> tag appears in search results, using this field may help visitors remember your site's true domain name.

seo-display-name.png

CMS Logo

Image that appears in the header.

Urls

List of URLs that prefix all pages in this site. Brightspot truncates any trailing slashes. For example, an entry http://www.desserts.com in this list creates URLs of the form http://www.desserts.com/mypage.

Preview URL

Domain that Brightspot uses to render the item in the preview pane. For example, if you enter http://previews.mydomain.com in this field, and you have an item Cookies, the URL for the preview is http://previews.mydomain.com/cookies. If this field is blank, Brightspot generates the preview from the server where editors logged in.

Site Category

Category with which site is associated. For information about creating site categories, see Creating site categories.

Basic HTTP Authentication

One of the following:

  • None—No authentication is required; all visitors can view content without HTTP authentication.

  • Set—Criteria for applying HTTP authentication.

    • Basic Authentication Users—A list of usernames and passwords that grant access to the site's server.

    • Basic Authentication Excluded Path Prefixes—Paths within a visitor's URL that are exempt from authentication.

    When a site has basic HTTP authentication, visitors connecting to the site see a message similar to the following:

    basic-http-authentication.png

Basic authentication is different from authentication provided by your site's front end.

Allow Site Copy

Allows administrators to create a new site by copying this site. For more information, see Copying sites.

Broadcast

Broadcast Message

Message appearing on top of the header.

Broadcast Expiration

Date and time when broadcast message expires. If blank, broadcast message has no expiration.

Dashboard

Dashboard

Default dashboard for editors working on this site. For information about creating dashboards, see How to create a shared dashboard.

Resources

Settings for the Resources widget. If blank, defaults to list of resources at the global level. For information about the Resources widget, see Resources.

Quick Start Settings

Content types that appear in the Quick Start widget. If None, defaults to settings at the global level. For information about the Quick Start widget, see Quick Start.

Bulk Upload Settings

Sets the default file type in the Upload Files widget. If blank, defaults to setting at the global level. For information about bulk uploads, see Upload.

Preview

Closed by Default

For mobile devices, preview pane is closed by default. Enable this option for the preview pane to be closed by default for other devices.

Preview Types

Previews generated by external applications, such as InDesign or a GraphQL server.

Default Preview Type

Default preview type from available preview types.

Preview Devices

List of devices available in the preview pane. If blank, all devices are available.

UI

Enable Sticky Search Filters

Retains values for common search filters when searching for a different content type. For example, if you first search for articles with status Draft, and then search for images, the setting for status remains Draft.

Advanced

CMS CSS Class

Additional lines of CSS code that alter Brightspot's appearance. For example, the statement label { text-decoration: underline; } underlines all field labels. If blank, defaults to the setting at the global level.

All Sites Accessible

If set, editors working in this site can access content owned by other sites. Overrides access settings in the Sites widget. For example, if the Sites widget indicates no other sites can access an item, marking this checkbox overrides that setting and editors of this site can access the item. (Editors logged in to the global site can always access content owned by other sites regardless of this setting.)

Accessible Site

List of sites whose items are available to editors of this site. For example, if an editor is logged in to the cookies site, and this list contains the cake site, then editors logged in to cookies can use items owned by cake. Overrides access settings in the Sites widget. For example, if the Sites widget indicates an item is owned by cake and no other sites can access an item, adding cake to this list overrides that setting and editors of this site can access the item. (Editors logged in to the global site can always access content owned by other sites regardless of this setting.)



Table 91. Front-end tab

Field

Description

Theme

Theme in which the site's front end appears.

Action Bar

Default Action Bar

Site's default action bar. Appears on all of the site's assets unless overridden for a content type.

Tracking Parameter Name

Tracking parameter appended to URLs for items shared from the action bar.

Type Specific Overrides

Action bars applicable to specific content types for this site. Overrides Default Action Bar.

Ads

Disable Ads Parameter Value

Value in a query string that blocks an ad feed. For an explanation of this field, see Blocking ads.

Ad Sizes

List of available ad sizes on this site.

CMS Preview Disabled Ad Sizes

List of ad sizes that are not populated with ads in the preview pane.

Ad Modules

List of Ad Sense or Ad Manager modules available for this site. Requires active accounts with these Google services.

Error

Error Handlers

List of HTTP error or status codes and associated pages that visitors receive. For information about configuring this field, see How to configure error responses.

Form CAPTCHA

Provider

reCAPTCHA service provider.

Layout

Hat

Site's hat. For more information, see How to make a hat.

Navigation

Site's navigation. For more information, see How to make a navigation.

Footer

Site's footer. For more information, see How to make a footer.

Above

Content appearing in the above block on all the site's page. For more information, see How to make an above layout block.

Aside

Content appearing in the aside block on all the site's page. For more information, see How to make an aside layout block.

Below

Content appearing in the below block on all the site's page. For more information, see How to make a below layout block.

Search Page

Page that lists results when a visitor searches for content. For more information, see How to make a site search.

Logos & Icons

Logo

Site's logo. Typically appears in the top left corner of each page.

News Publisher Logo

Renders a site logo that complies with width and height restrictions for AMP.

Favicon

Site's favicon appearing in browsers and some mobile apps. Use .png or .jpg files.

Favicon Ico

Site's favicon appearing in browsers and some mobile apps. Use .ico files.

Open Graph

Default Open Graph Image

Image appearing in social networks when an item is shared.

Permalinks

Permalink Rule Overrides

Configures how Brightspot generates permalinks for a site-content type combination. For each content type, you can configure one of the following rules:

  • Default Permalink Rule—Brightspot generates permalinks from an item's slug.

  • No Permalink Rule—Brightspot does not automatically generate a permalink; editors must manually create permalinks for each item.

  • Section Prefix Permalink Rule—Brightspot generates permalinks from a combination of the section's slug and the item's slug.

For each rule, you can specify how Brightspot resolves duplicate permalinks.

  • Inherit—Use the rule inherited from the global site.

  • Disabled—Do not automatically resolve duplicate permalinks; editors must resolve them individually.

  • Enabled—Brightspot appends a number to duplicate permalinks, incrementing the number for each new duplicate.

RSS Settings

Disable Feed

If toggled on—

  • Brightspot stops populating your site's RSS feed.

  • Removes the existing feed and its previously included items.

Copyright

Copyright notice appearing in the feed's copyright tag, which not all RSS readers display.

Default To Atom Auto Detect

If toggled on, the feed is a discoverable Atom feed. If toggled off, the feed is a discoverable RSS feed.

Type Specific Feed Overrides

Feed configurations for specific content types. For homepages, pages, sections, and tags, you can configure the following:

  • Disable Feed—Enables or disables the feed.

  • Render Full Content—Delivers the entire item—not just a summary—to the RSS feed as plain text.

  • Enabled Feed Item Types—Content types associated with these settings, or leave blank to apply the settings to all content types

The settings in this field override Disable Feed.

SEO

robots.txt

Lines to includes in the site's robots.txt file. For detailed information about this file, see Robots.txt Specifications.

Sitemap Settings

Site Map Types

One of the standard sitemap types.

Site Map Default URL

Default URL appearing in the site's sitemap.

Social

(Various)

Fields for social network accounts' usernames.

Type Specific Overrides

Type Specific Landing Page Content

Modules appearing in a landing page for a section or a tag. For example, you can have a list of authors appearing at the bottom of each landing page for a section.

Type Specific Overrides

Page layout overrides by content type. For example, you can have a footer for author pages that is different from your site's footer. For more information, see How to apply type-specific overrides.

Advanced

Time Zone

Time zone used to compute the published time as reported in some <meta> tags. For example, your Brightspot server is in New York and you publish an item at 9:00 AM. In addition, you set this field to Europe/London. In this case, Brightspot renders <meta property="article:published_time" content="2021-03-29T14:00:00.000">, indicating the item was published at 2:00 PM.

Browser Config

The browserconfig file delivered to clients from this site. For information about composing this file, see Browser configuration schema reference.

Web App Manifest

Web app manifest delivered to clients from this site. For information about composing this file, see Web app manifests.

Custom Scripts and Styles

<link>, <meta>, <script>, and <style> elements included in web pages delivered from this site—beyond what is defined in the site's theme. You can send different sets of custom tags to specific clients by filtering on HTTP method, URL pattern, and content type.

Custom Response Headers

Response headers sent to clients—beyond what is configured for the site's server. You can send different response headers to specific clients by filtering on HTTP method, URL pattern, and content type. For information about configuring response headers, see Response header.



Table 92. Integrations tab

Field

Description

Integrations

List of third-party apps with which the site interacts. Examples include Google's AdSense and Video Analytics.

Disable Third Party Parameter Value

Value in a query string that blocks interacting with the third-party app.

Facebook

Facebook Settings

App ID for a Facebook app.

Google DFP

Window Sizes

List of window sizes to which DFP sends ads.

DFP Tag Import

Document header script. You can generate the script using Ad Manager Tag Generator & Tester.



Table 93. Localization tab

Field

Description

Locale Provider

Method by which the server announces its locale to clients.

  • None—Locale is suppressed.

  • Content—Locale appears in the <html lang> attribute.

  • System Default—Locale announced by the server.

Available Locales

Locales available for use.

  • Locale—Standard listing of languages and country codes.

  • Custom Locale—Locale you can define from a language, region, script, and variant. For information about specifying a custom locale, see Constructing Language Tags.

Localization Badge Display

If toggled on, badges are localized.



Table 94. Content Discovery tab

Field

Description

CMS

Have Read Access

List of sites that have access to content on this site. For example, the administrator for Site A added Site B to this list. An editor working on Site B can view the items in Site A.

If this list is empty, editors working on any site can view the items in Site A.

This field is in effect after toggling on Read Only Across Sites in Sites ad Settings > Global Site > Debug tab > Read Only Access.

Front End

Front End Accessible Sites

List of sites whose visitors can search for and view items on this site. For example, the administrator for Site A added Site B to this list. A visitor logged in to Site B can search for and view content published on Site A.



Table 95. Debug tab

Field

Description

Strip Query String From Directory Redirects

A client's request for a resource may trigger a redirect to a different directory. Toggle on this field if you want to strip the query string from the request before the server performs the redirect.