Teaser
A content preview card that links to another page. Selecting a target page via the object browser auto-fills the title, description, and preview image from that page. Editors can toggle "overwrite" to customize these values.

Developer Reference
Schema
Pass this object inside the blocks option when calling initBridge() to register this block type with the admin UI. See Custom Blocks for the full setup guide.
{
"fieldsets": [
{
"id": "default",
"title": "Default",
"fields": [
"href",
"overwrite",
"title",
"head_title",
"description",
"preview_image"
]
}
],
"properties": {
"href": {
"title": "Target",
"widget": "object_browser",
"mode": "link",
"allowExternals": true
},
"overwrite": {
"title": "Customize teaser content",
"type": "boolean",
"default": false
},
"title": {
"title": "Title"
},
"head_title": {
"title": "Kicker"
},
"description": {
"title": "Description",
"widget": "textarea"
},
"preview_image": {
"title": "Image override",
"widget": "object_browser",
"mode": "image",
"allowExternals": true
}
},
"required": [
"href"
]
}JSON Block Data
Example JSON as stored in the Plone content API. This is the data structure your component will receive in the block prop.
{
"@type": "teaser",
"description": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.",
"styles": {
"align": "center"
},
"head_title": "Head title",
"title": "Headline H2",
"href": [
{
"@id": "/docs/examples/content-types/page",
"@type": "Document",
"Description": "The Page content type can be used to display content on a single page of the website. Pages can be structured using text, images and blocks.",
"Title": "Page",
"getRemoteUrl": null,
"hasPreviewImage": true,
"head_title": null,
"image_field": "preview_image",
"title": "Page"
}
]
}Rendering
How this block renders in your frontend. Add its handling to your renderer, or — for list-style blocks — register a fetcher and reuse your list rendering.
import { getImageUrl } from './utils.js';
function TeaserBlock({ block }) {
const hrefObj = block.href?.[0] || null;
const useBlockData = block.overwrite || !hrefObj?.title;
const title = useBlockData ? block.title : hrefObj?.title || '';
const description = useBlockData ? block.description : hrefObj?.description || '';
// Strip API origin from brain @id so the link resolves same-origin.
const href = contentPath(hrefObj?.['@id'] || '');
const imageSrc = block.preview_image
? getImageUrl(block.preview_image)
: (hrefObj?.hasPreviewImage ? getImageUrl({ '@id': `${href}/@@images/preview_image` }) : '');
if (!href) {
return (
<div data-block-uid={block['@uid']} className="teaser-placeholder">
<p>Select a target page for this teaser</p>
</div>
);
}
return (
<div data-block-uid={block['@uid']} className="teaser-block">
{imageSrc && <img data-edit-media="preview_image" src={imageSrc} alt="" />}
<h3 data-edit-text="title">{title}</h3>
<p data-edit-text="description">{description}</p>
<a href={href} data-edit-link="href">Read more</a>
</div>
);
}