You can automatically add inline prompts to article content or above the site header.
Alternatively, you can manually add prompts to a specific place in the article or page content using custom placements. Prompts assigned to a custom placement will appear only if you manually insert its custom placement block.
Note: The Custom Placements system replaces the “Manual Placement” frequency and manual placement of prompts via shortcodes. We’ll automatically reassign prompts with the “manual placement” frequency to a custom placement with the default “Until Dismissed” frequency. You can continue placing prompts manually placed via shortcode for legacy purposes. But we recommend replacing these with custom placement blocks to ensure that they still display in the future.
Assigning Prompts To Custom Placements
Every Newspack site comes with three custom placement slots by default. You can insert these custom placements into any article or page using the Custom Placement block. To place prompts using custom placements:
- Go to Newspack > Dashboard > Campaigns and create or edit a prompt in any segment. From the “Add New Prompt” menu, choose the “Custom Placement” option:
- In the editor sidebar, expand the Settings panel. In the Placement dropdown, you’ll see options for Custom Placement 1-3. Note that these options are only available if the prompt type is set to inline.
- Select one of the custom placements and save the prompt. We will no longer insert this prompt programmatically anywhere on the site. Note that you can assign multiple prompts to the same custom placement; this lets you display different prompts to different audience segments in the same place.
Adding Custom Placements To Articles and Pages
You can only display prompts assigned to a custom placement where you add them to an article or page content. To display prompts assigned to a custom placement:
- Edit the post or page where you want the prompts to appear.
- Using the block inserter, insert a Campaigns: Custom Placement block (you can find it under the Newspack block category):
- Select the custom placement with the prompts you want to display using the dropdown. If you do not choose a custom placement here, or the custom placement you choose doesn’t have any prompts assigned to it, the block won’t render anything.
- After selecting a custom placement, the editor preview will update to display a list of the currently active prompts assigned to that custom placement and grouped by segment in order of priority. Click on a prompt’s name to edit that prompt:
- Save the post or page. You can place the same custom placement in multiple posts or pages, and all instances of that custom placement will show the same prompts. If you change or deactivate the prompts assigned to a custom placement, the system will automatically update all of its instances.
What Happens When Readers View a Custom Placement
When readers visit a post or page containing a custom placement block, they may see one of the active prompts listed in the editor preview, if they match one of the segments shown.
Similarly to overlays and above-header prompts, each custom placement will display at most one prompt — the prompt with the reader’s highest-priority audience segment. The system will display prompts assigned to a custom placement under the “Everyone” segment only to readers who don’t match another segment.
Assign no more than one prompt per segment to the same custom placement for the best results. If you assign more than one active prompt to the same segment and custom placement, the system will display a warning in the Campaigns dashboard, and it will show only the most recently created prompt to readers.
On this page
- Assigning Prompts to Custom Placements
- Adding Custom Placements to Articles and Pages
- What Happens When Readers View a Custom Placement
Campaigns Table of Contents