Skip to main content

Topic

Similar to an article, a topic is a building block piece of content that an editor places into a book. After you add a topic to a book, you can arrange the topic in the table of contents so that it is easily accessible to your visitors.

Creating topics​

To create a topic:

  1. In the header, click .
  2. From the Create list, select Topic.
  3. Using the following table as a reference, complete the fields as needed.
  4. Complete your site's workflow and publish the topic.
FieldDescription
HeadlineEnter a headline. This headline is visible to the visitors to your site.
SubheadlineEnter a subheadline. This subheadline is visible to the visitors to your site.
URL SlugThis field, by default, is auto-populated by a Title, Name, Display Name, or Headline field, and becomes part of the asset's URL.

Auto-populated slugs are lowercase, have diacritics removed, and any symbols or spaces are replaced with -.

You can modify the URL Slug field if necessary.
BodyUse the rich-text editor to include text, lists, images, and links to other assets. Text in this field is visible to visitors to your site.

For information about using the rich-text editor, see Rich-text editor.
See AlsoA module containing additional links that is visible to visitors to your site. The See Also module is intended to link visitors to other relevant content.
EmbargoSelect a date and time before which you cannot publish the asset, or select Indefinitely to prevent publication indefinitely. (You can move the asset through a workflow, and schedule it for publication any time on or after this date.) This field becomes read-only after you publish the asset.
TagsSelect the tags associated with this asset. This selection is visible to visitors to your site.

For information about creating a tag, see Tag.
AttachmentsSelect one of the following:

- Basic—Creates a list of attachments.
- Advanced—Creates a list of attachment promos that you can customize.

Click 📤 below the Attachments field to upload files, or click ➕ below the Attachments field and use the content picker to select the attachments you want to add to this list. You also have the option to create new attachment from this menu as well. See Attachment File for more information on creating a quote.

Adding anchors​

Brightspot allows you to add anchors to a topic. Anchors allow you to break your topics into smaller sections that can be linked to from other assets.

Brightspot preprends anchors with a #, both within the topic itself and also in the table of contents of the book after the topic is published.

Anchor tag with # shown

To add an anchor to a topic:

  1. Search for and open a topic to which you would like to add an anchor, or create a new one.
  2. In the rich-text editor, position the cursor inside a paragraph or at the beginning of a new paragraph.
  3. In the rich-text toolbar, click Format > H2.
  4. Repeat steps 2–3 to add additional anchors.
  5. Complete your site's workflow and publish the topic.

Disabling anchors​

You may find it useful to use H2 formatting without creating anchors within your topics. Brightspot gives you the option to disable anchoring while retaining H2 formatting.

To disable anchors in a topic:

  1. Search for and open a topic to which you would like to disable anchors.
  2. Toggle on Advanced > Disable Subheading Anchors. By default, this is toggled off (which enables the anchors).
  3. Complete your site's workflow and publish the topic.

See Also module​

You can provide a list of related topic links using the See Also module, available at the bottom of the topic content type.

To place a See Also module:

  1. Search for and open the topic to which you want to add a See Also module, or create a new topic.
  2. From the See Also list, select Inline.
  3. Using the following tables as a reference, complete the fields as needed.
  4. Complete your site's workflow and publish the topic.

See Also fields​

Click each tab below to see a description of the associated fields.

FieldDescription
TitleSet the Title for the group of see-also topics.
ItemsSelect one of the following:
- Basic—Adds topics to the list. A rendered basic list includes promos of the underlying topics, and you cannot override the promos' text or image.
- Advanced—Adds topics' promos to the list. You can customize the promos' text and image. Your customizations remain even if a topic's promo changes. See Product Promo module for more details on these fields.
- Dynamic—Adds topics' promos to a list that dynamically updates according to the settings you select. See Understanding dynamic list settings for more information on these settings.