The Featured Card block and accompanying shortcode lets you display a polished summary card for any Person, Place, or Source entry right inside any post, page, or post type. It’s a great way to highlight a key subject, introduce a central figure, or point readers toward a related entry without interrupting the flow of your writing.

There are two methods to display a featured card. If you use the native WordPress Gutenberg post editor, choose the block method. If you are using a page builder or the classic WordPress editor, use the shortcode method.

The Featured Card Block #

Adding a Featured Card #

1. Open the post or page where you want to add the card.

2. Click the + button to add a new block (either in the content area or in the block inserter panel on the left). Search for Featured Card and click it.

3. The block appears in your content with a prompt asking what you’d like to feature. Click Person, Place, or Source depending on what you want to display.

4. A search box appears. Start typing the name of the entry you want to feature — results appear as you type. Click the correct entry to select it.

5. The block immediately shows a preview of the card as it will appear to visitors.

Changing what information appears on the card #

With the Featured Card block selected, look at the right-hand sidebar — you’ll see several options under Display Fields.

This is a checklist of the available information fields for the entry type you chose. Tick or untick fields to control exactly what appears on the card. For a Person entry, for example, you might choose to show Date of Birth and Occupation but hide Nationality.

Card style #

Also in the sidebar, under Card Style, you can choose between three visual styles:

• Standard — A full card with an image area, title, and fields listed below
• Compact — A condensed version, good for sidebars or tighter layouts
• Minimal — Title and fields only, no image area

Try each one to see which fits best in your layout.

Show excerpt #

Toggle Show excerpt on if you’d like to include the entry’s excerpt (a short summary) on the card. This is off by default.

Changing the featured entry #

If you want to swap the card out for a different entry, click the Change entity button in the block’s toolbar (the small pencil icon that appears when the block is selected). This returns you to the search step so you can select a different entry.

To change the entity type entirely (from a Person to a Place, for example), click Change entity type in the toolbar.

The Featured Card Shortcode #

The Featured Entity Card shortcode displays a styled card for a Person, Place, or Source anywhere shortcodes are supported.

Featured Cards are ideal for:

• Highlighting important people
• Showcasing places
• Promoting source material
• Creating related-content sections
• Building custom landing pages

---

Basic Usage #

[cp_featured_card type="cp_person" id="123"]

Displays a featured card for the Person with ID 123.

---

Display Specific Fields #

[cp_featured_card
    type="cp_person"
    id="123"
    fields="_cp_birth_date,_cp_death_date,_cp_occupation"
]

Displays only the selected fields.

---

Show the Excerpt #

[cp_featured_card
    type="cp_person"
    id="123"
    show_excerpt="1"
]

Displays the entity excerpt beneath the card details.

---

Change the Card Style #

[cp_featured_card
    type="cp_person"
    id="123"
    style="standard"
]

The available styles depend on your ChroniclePress installation and any installed Layers.

---

Available Parameters #

Parameter	Description
type	Entity type (cp_person, cp_place, cp_source)
id	Entity ID
fields	Comma-separated list of fields to display
style	Card style
show_excerpt	Display excerpt (1 or 0)

---

Entity Types #

People #

type="cp_person"

Places #

type="cp_place"

Sources #

type="cp_source"

---

Example: Person Card #

[cp_featured_card
    type="cp_person"
    id="123"
    fields="_cp_birth_date,_cp_death_date,_cp_occupation"
    show_excerpt="1"
]

This creates a card containing:

• Featured image
• Entity type label
• Entity title
• Selected fields
• Optional excerpt
• Link to the entity page

The card automatically updates whenever the entity is edited.