How to add Content Preview

Last updated 02/14/2024

Before adding content preview make sure you have added the initialization script tag.

The content preview feature allows you to limit access to specific web pages on your website to visitors that have authenticated. When the user goes to the page, the content is partially hidden by the content preview sign in section. It can be configured to appear immediately, after a period of time, or when a user scrolls past a certain percent of the page.

You can also customize the text content at the bottom to meet your unique business needs. Once signed in, users can see the page content.

This guide explains how to add content preview to any page on your site, and how to configure the text content you want it to display.

Step 1

Find the initialization script you have added to your webpage (see initialization script if you have not added it already)


Step 2

In the initialization script, find the line:

BreadButter.configure({app_id: "[APP_ID]"});

Step 3

Add the following line under BreadButter.configure();

 BreadButter.ui.contentPreview({
    restricted_links: ["CONTENT_PREVIEW_PAGE"],
    scroll_limit: 0,
    time_limit: 0,
    clickable_content: false,
    fixed_height: 75,
    locale: {
       POPUP: {
            TEXT_1: 'HEADER',    
            TEXT_2: 'SUB HEADER',
            TEXT_3: 'BOTTOM TEXT',
            TEXT_3_2: 'BOTTOM TEXT EXPANDED',
            MORE: 'EXPAND LABEL',
        }
    },
});


Step 4

Replace CONTENT_PREVIEW_PAGE with the page (or pages) you want to apply content preview to. Enter the URL like this:

["/work"]

Or like this for multiple pages:

["/work/project-1", "/work/project-2"]

You can also use a wildcard * to block all URLs under /work/, like /work/projects, but not including /work:

["/work/*"]


Step 5

The remaining fields in the POPUP object allow you to customize the text that appears in the header, and below the sign in options. If you remove the POPUP part of the code snippet, default content will be used.

  • Replace HEADER with custom header text to help your users understand what is happening.
  • Replace SUB HEADER with additional content below the header, to further communicate with your users.
  • Replace BOTTOM TEXT with a short line of text you'd like to display to your users below the sign in options. This could explain why it's important or valuable for the user to complete the sign in process.
  • Replace BOTTOM TEXT EXPANDED with a more detailed or longer explanation of the value of signing in. This content will replace TEXT_3 when a user clicks the "MORE" option.
  • Replace EXPAND LABEL with the label for the expand link. We recommend setting this to "more>>".

Step 6

  • For scroll_limit, choose a value between 0 and 1. Setting it to 0 will load immediately, 0.5 after half of the page is scrolled through, etc. Make sure to set the time value very high if you want content preview to be triggered primarily through the scrolling action of the user.
  • For time_limit, choose the number of seconds after page load until content preview is displayed.
  • For clickable_content, set to true if you want the content above the content preview to be clickable, such as header links etc.
  • For fixed_height, set the maximum percentage of screen space (from 0 to 100) that you want content preview to take up. If not explicitly set, the default behavior is to allocate sufficient space to accommodate all authentication content.

Step 7

You should now see the content preview tool appear on the specified page, after the specified time period.



Don’t use Bread & Butter? Want to learn more about how Bread & Butter solves the four biggest problems facing marketers today? Book a demo and see how Bread & Butter is helping marketers make the most of their first-party data