Support and Documentation


Articles tend to be the backbone of any website, and can be used for a variety of use cases. Articles can serve as evergreen content, with a large body of text to support a privacy policy, or they can be used to feature brief updates about a breaking news event. They are highly flexible and have myriad uses.

Articles are by nature a text-based asset in Brightspot, and have a built-in set of fields with their own built-in behaviors. Here's a quick overview of the most important fields.

  • Headline: The headline field is a required text field with a small rich-text editor (meaning simple formatting like italics is supported). The text that an editor inputs into the headline field is automatically used by Brightspot to populate the asset's URL, the asset's SEO meta title, as well as the asset's internal Promo Title (how this asset will display around the site itself, such as in dynamic modules) and external Share Title (how this asset will appear on other websites—for example if a user shares it on a social network). An editor can choose to write custom text for any of those placements, but Brightspot automatically populates those fields with the headline to be helpful.

  • Subheadline: Also a simple rich text field. The text a user inputs into the subheadline field will be used to populate the asset's SEO meta description, the internal Promo Description, and external Share Description. Again, the user can choose to write custom text for those fields that inherit the subheadline; this autopopulation is designed to help the editor work more quickly.

  • URL Slug: The URL slug field can be used to overwrite the asset's permalink. For example, if an editor wanted the asset's Headline field and permalink to vary, the URL Slug field can be used to accommodate that variance.

  • Authors: Assets support the association of one or many Authors.

  • Lead: Brightspot supports the addition of a Lead with an asset. The Lead might be an Image or a Video.

  • Body: The Body field is where the narrative of the asset will be populated. This is a rich-text field with the full Brightspot rich-text editor, which supports a whole host of formatting options (bold, italics, bulleted lists) as well as hyperlinks (internal and external), enhancements (such as images, galleries, videos, and social embeds), and advanced editing capabilities like track changes and commenting. The Body field also supports a full screen, immersive mode, where an editor or writer can work and focus solely on the contents of the Body field.

  • Section: Assets can be associated with a Section, with a maximum of one. If a Section is populated on an asset, it will also drive the asset's permalink. For example, an asset titled "My Asset" that is added to a Section called "Publishing" will result in a permalink of /publishing/my-asset. Typically the Section is associated with a site's navigation and describes the "aboutness" of the content to drive discoverability.

  • Tag: Assets can be associated with one or many tags. Think of tags as additional ways that a visitor might want to discover this content. If the Section is what the asset is most "about," then Tags are other, additional things the asset is also about.

  • Embargo: Brightspot supports setting an Embargo on assets to prevent sensitive content from being published before a given time. Assets can be embargoed Indefinitely (meaning that they will not be publishable until that Embargo setting is removed) or Until a given date and time.

In addition to the fields above, assets incorporate many authoring capabilities within Brightspot as well.