There are several different prompt types: overlay, which appear as a pop-up over the site, inline, which appear inline with your site content, above header, which appear at the top of the site, and custom placement, which can be placed on any page or post.
Add a New Prompt
To create a new prompt, follow these steps:
- Navigate to Dashboard > Newspack > Campaigns. The list of prompts shown by default is “Active Prompts,” or all prompts that can be seen by readers. Click the campaign filter dropdown to choose a campaign to manage. Note that if you add a prompt while viewing the “Active Prompts” filter, the prompt will be listed under the “Unassigned” filter.
- Any segments you’ve created will be listed here. To create a prompt, click the ? button next to the segment you want to assign the prompt to.
- Choose the type of prompt you’d like to create.
- Prompts are edited like posts or pages, using the Gutenberg editor. For convenience, Newspack Campaigns provides several prefabricated block patterns which you can access by clicking on the
logo in the upper-right corner of the editor page. (Note that newsletter signup forms require that you connect a Mailchimp account with Jetpack.) Otherwise, you can use any blocks you can use in posts and pages to build your prompts.
When editing a prompt, you have a number of options that will appear under the Prompt tab in the right sidebar:
Status & visibility
Preview: The Preview will let you view your prompt in a new window as it will look on the site, without activating it. In the top-left corner, you can switch between different screen sizes to see how it will look on different devices:
Inline Prompt: Toggling on and off this option will switch your prompt from an inline prompt to an overlay prompt.
When you have a prompt with the Inline placement, you’ll have the following options:
Placement: You can opt to place the prompt in the article content, above the site header, or in a custom placement slot.
When the prompt is placed in the article content, you will have the option to set its Approximate Position (in percentage), to set roughly how far down the post body to insert the prompt.
Refer to the page on Custom Placements for more details on placing prompts manually.
When you have a prompt with the Overlay placement, you’ll have the following options:
Placement: You will be able to choose whether the overlay is centered, at the top of the viewport or the bottom.
Trigger: Whether to use a timer or scroll position to determine when the overlay is displayed.
When Timer is selected, you will be able to set the Delay (seconds), the time that passes before the overlay is displayed.
When Scroll Progress is selected, you will be able to set the Scroll Progress (percentage), the approximate distance a visitor has scrolled down the page before the overlay is displayed.
Display Prompt Title: For both the Inline and Overlay prompts, you will have the option to display the prompt’s title at the top. If you opt not to do this, the title can be used for descriptive purposes, and you can use the Header block to insert a header in the prompt’s content.
Hide Prompt Border: Inline prompts are displayed in a container with a faint border and a small amount of padding around the prompt’s inner content, by default. Enabling this option will display the prompt without the border or padding.
Frequency: How often to show the prompt. When using Inline placement, you will have the option to show the prompt Once, Once a day, or Until Dismissed. When using the Overlay placement, you will have the option to show the prompt Once, or Once a day. Note that if you do not define a dismiss button label (see Dismiss Button Settings below), setting the frequency to “Until Dismissed” will render the prompt undismissable.
UTM Suppression: a UTM code is a snippet of code that can be added to the end of a URL, to be used with prompts. You can use it in the Pop-Up setting to prevent the popup from displaying when visitors have come to the site using a specific URL. So for example, if you had a pop-up promoting your newsletter, you wouldn’t need to show it to a visitor who got to the site following a link from your newsletter.
To use it, you would add
?utm_source=newsletter to the end of the URLs in the newsletter that point to your site, and add “newsletter” to the UTM Suppression field. The word you use as the
utm_source is arbitrary — using
spatula would work just as well, as long as the
utm_source and UTM Suppression field match.
Read more about UTM tracking in Mailchimp here.
Segment: Select an audience segment to assign this prompt to. The prompt will only be displayed to readers who match the selected segment. Read more about setting up audience segmentation here. If you don’t choose a segment, the prompt will be shown to all readers.
Dismiss Button Settings
Controls the link at the bottom of the prompt that readers can use to permanently dismiss it. Permanent dismissal buttons are common practice in Overlays, but often unnecessary for Inline prompts.
Label: Text that’s used for the dismiss button. The default value is “I’m not interested”. If no dismissal button is needed, leave this field blank.
Alignment: Alignment of the dismiss button; by default it’s set to Center, but you can also align it Left or Right.
Background Color: This control will let you change the background color of the prompt. The default background color is white. Changing the background color—even subtly—can help it stand out from the rest of your site’s content.
Overlay Color: When the Overlay placement is selected, you will have the option to change the overlay color. By default, the overlay uses a dark gray.
Overlay opacity: When the Overlay prompt placement is selected, you will have the option to change the overlay opacity. By default, the overlay uses a 30% opacity.
When one or more categories are assigned to a prompt, that prompt will only show up on posts with those categories.
Note: If a post has only the “Uncategorized” category, it will be treated the same as posts with no categories. The Campaigns dashboard will not show the “Uncategorized” category for this reason.
When one or more tags are assigned to a prompt, that prompt will only show up on posts with those tags.
Campaigns are a way to organize your prompts. You can create new campaigns or assign existing campaigns from this section. You can also create new campaigns and manage existing campaigns in the Campaigns dashboard.
When you’re satisfied with your prompt’s content, click Publish to activate the prompt. You can also choose a future time and date to schedule the activation. Once activated, the prompt will be displayed to readers who match the prompt’s assigned segment.
If you’d like to save your progress without activating the prompt, click Save draft. Prompts with a draft, pending review, or scheduled status will not be displayed to any readers.