Managing Rich Link Preview Content

Content Layer

name	Page Info
id	278129461
class	watermark-layer

Content Column

name	Page Body
width	100.00001%
id	278129463

Content Block

background-color	transparent
name	Prompt
id	494677873
class	tight manual-prompt-flex

Leveraging the powerful design options available with Rich LinksDetermining what gets served up to the user when a link is displayed as a Rich Link.

Content Block

name	Outcome
rich-link-hovers	true
id	1042866408
class	tight manual-outcome-flex

With the pre-formatted advance styling of Rich Links, content details are "pushed" to a destination page from a another linked page. (This can greatly enhance the user experience, adding contextual information where it's needed, without weighing a page down unnecessarily.)

When a Rich Link is displayed on a page, Theme Press looks for the following information from the linked page:

Title
Description
Image
Space name
Space icon

linked page to serve up Rich Link content

Any block on a page can be designated for Meta Properties. This is the first place Theme Press will look for metadata to display within the Rich Link preview.

No Meta Properties block selected?

Theme Press will cascade through the following areas if no block on the page has been selected.

Image

Attachment

The first image found in the attachments list

with the label "rich-link"

The first image found in the first

Image in an excerpt macro

The first background image from a page attachment found on a content-layer on the page (checks the container, then the layer)

The first background image from a page attachment found on a content-block on the page

The first image found embedded on the page

The first image found in the attachments list

Any attached image

Title

The page title

Description

It will look for the title here...

The text from the first

heading, checking the higher-level headings first

The page title

The text from any paragraphs

paragraph in the Excerpt macro on the page
The text from

any paragraphs

the first paragraph in the first Content Block on the page
The text from any

paragraphs

paragraph in the page body

, truncated to 255 characters

Note: A rich link will only display one paragraph of text in the description and will not pull content from multiple paragraphs.

Content Block

name	Steps
rich-link-hovers	true
id	494842117
class	numbered steps-block numbered manual-steps-flex

Select a block on the

destination page that has the "Meta Properties" tag selected.

You'll find it here:

^{Theme Press Control Panel > Page tab > Block > Handling > Meta Properties}

Creating a Block to Manage Rich Link Content

For tight control over rich link content display, it's advantageous to create a first block on the destination page that is hidden and will be used ONLY for a rich link, but will otherwise be invisible to users. In addition to the Meta Properties check box being selected for the block, also set the Initial Display to collapse.

If there is no block with Meta Properties selected, the content will be found according to the following scheme:

Expand

title	It will look for the main image here...

Expand

title

Expand

title	It will look for the description here...

Content Block

name	Note
rich-link-hovers	true
id	495965127
class	manual-note-flex
collapsible	collapse

Note

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.

Content Block

name	Tip
rich-link-hovers	true
id	894522670
class	manual-tip-flex	collapsible	collapse

Tip

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

High-touch Rich Link Previews

For tight control over Rich Link preview display, you can create a 'hidden' block that exists only to serve up curated preview content. To do so:

Check the Meta Properties box for this block.
Set Initial Display to collapse.

Content Block

name	Warning
rich-link-hovers	true
id	894530759
class	manual-warning-flex
collapsible	collapse

Warning

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

Content Block

name	Info
rich-link-hovers	true
id	894537203
class	manual-info-flex
collapsible	collapse

Info

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

Content Layer

background-color	$lightGrayColor
name	Related
id	888168050

Content Column

name	Related
width	100%
id	888168051

Content Block

rich-links-hide-description	true
rich-link-hovers	true
rich-links-columns	4
rich-links-vertical	true
rich-links-image-height	100px
rich-links-hide-site-icon	true
rich-links-details-padding	10px
name	Related
rich-links-enable	true
border-width	0
rich-links-details-alignment	left
rich-links-margin	20px 30px 0 0
id	496234544
class	related-block clean manual-related-flex

Rich Links
Rich Link Macro Parameters and Key
Designating Links as Rich Links
Designating a Block for Meta Properties
Replace me with a link
Replace me with a link
Aim for 4 or fewer related links. If we need more, that's okay. Be judicious. Delete me when you're done.

Page tree

Transform Your Digital Workplace

Industry Expertise

Inform Your Strategic Direction

Redefining Work

Documentation and Support

Versions Compared

Old Version 11

New Version Current

Key

linked page to serve up Rich Link content

No Meta Properties block selected?

Image

Title

Description

More Tightly Controlled Curation of Rich Link Content

Select a block on the

Creating a Block to Manage Rich Link Content

Platform

Company

Support

Brikit Services