Curations offers a Display manager that makes it easy to route content to display. The Display manager is an intuitive and feature-rich wizard that guides you through the choices available to you when creating a new display. Using the Display manager, you define the type of display you want to create as well as what content should be associated with the display. When you’re done configuring the display, the Display manager generates the code that renders displays, so you can copy and paste the generated code wherever you want the display to appear on your site.

When you open the Displays tab, you’ll see the Display manager. This topic covers the essentials of working with the Display manager.

How the Display manager works

The Display manager allows you to configure filters that define what content should appear in a display. For example, you can create a display that filters content based on the author of a post or on specific text included in the post. You can also configure additional display options, such as the sort order of posts or the required moderation status. Common display options include:

  • Moderation status
  • Author permission status
  • Whether the display is on a normal page or on a product page

    Note: Only displays on product pages require a product ID. Refer to Step 3: Tag for display on product pages in the Displaying curated content guide for more details.

  • Whether the display allows review content
  • Whether the display allows featured posts
  • How posts are sorted in the display

Example

Say you created a Curations display for your summer campaign landing page. You want that display, summer_landing, to include all content labeled with summer_campaign. You can use the Display manager to configure the display to find all posts that:

  • Are approved.
  • Have the author's permission for use on your site.
  • Have the label summer_campaign.

Create a display

To create a new display:

  1. Click Create Display.
  2. Click Configure Options > to configure the following options for the display:
    • Moderation status—Bazaarvoice recommends you set this status to Approved. This limits the display to posts that have been approved by either Bazaarvoice moderators or someone at your company.
    • Author permission status—Bazaarvoice recommends you set this status to Approved and Bypassed. This limits the display to posts that have received permission for use.
      Note:  Instagram and Twitter require that you obtain an author's permission before reusing their post.
    • Display type—Choose the type of display based on where on your site you plan to place the display. You can select General purpose page for most use cases. If you plan to place the display on a product details page (PDP), choose Product page. If you plan to place the display on a category page, choose Category page.
      Note:  If you select a Product or Category display type, use the drop-down menu in the upper right of the preview pane to preview what posts show in the display according to the product ID you select. After you finish creating the display in the Display manager, you enter the product ID in the integration code that you copy.
    • Review content (for Product and Category displays only)—Enable this option to have the display accept Ratings & Reviews content. You can select a Minimum rating for reviews that the post must meet before appearing in the display.
    • Featured content—Enable this option to have the display accept featured posts that always appear first, regardless of recency. You can specify the Maximum featured posts that the display allows.
    • Personalize content (for General purpose and Category displays only)—Enable this option to display posts personalized to shopper preferences. You can specify the Maximum personalized posts that the display allows.
    • Content sorting—Choose how to sort the posts in the display:
      • Newest to oldest—Most recent posts display first.
      • Oldest to newest—Least recent posts display first.
  3. Click < Configure options to return to the Display manager menu.
  4. Click Define content > to add filters that determine what content appears in the display.
    Note:  The display will only accept posts that meet the requirements of every filter configured. When an individual filter accepts multiple values, posts only need to match one of those values unless you configure the filter to require all values.

    If you need help with filters, refer to the list of available content filters.

  5. Click < Define content to return to the Display manager menu.
  6. Click Naming to configure the following naming options for the display:
    • Display name—Provide a name that helps you identify the display within the Curations display table. This name is internal to your account and is not surfaced to shoppers.
    • Display code—Provide a name that uniquely identifies the display in the integration code you add to your site. This name is included in your site’s HTML and displays in Curations reports.
      Note:  This name must be lowercase, cannot contain spaces, and is not editable after the first save.
  7. Click Save.
  8. Click View rule for the display you just created.
  9. In the right pane, click Integration.
  10. Copy the div element and paste it in your integration code anywhere you want to render the display on your site. <div class="note">Note:  If you selected a Product or Category display, include the product ID you want to associate with the display in the data-bv-product-id attribute of the div. element</div>

Manage existing displays

View all displays

Open the Displays tab to view the following information:

  • Name—Shows the name provided when setting up the display.
  • Filters—Lists the number of filters that apply to the display. Click the number to view the full list of filters.
  • Display code—Shows the display’s unique code indentifier. Any integration code that uses this identifier will render a display with the options specified in the rule definition.
  • Display type—Shows whether a display is designed for a general page, a product-specfic page, or a category-specific page.
  • Created—The date the display was created.
  • Last modified—The date the display was last modified.
  • State—Lists the current state of the display and allows you to pause or enable a display.

You can use the Displays tab to edit, pause, enable, and delete a display.

Edit a display

You can edit the display options, filters, and name of any existing display. After you save your changes, the display refreshes its content to satisfy the new configuration.

For example, suppose you create a display that shows content that has the labels “oranges” and “bananas”. After you save the display, it shows posts with a mix of oranges and bananas. If you edit the display and remove the “bananas” label from the display, the content for the display refreshes to show only oranges from that point forward.

To edit a display:

  1. From the Displays tab, click View rule for the display you want to edit.
  2. Edit the display options, filters, and name as necessary.
    Note:  You cannot edit the display code after first save.
  3. Click Save.

Pause a display

Pausing a display stops the display from collecting new content, effectively making the current posts static on the display.

To pause a display, click the toggle next to the display you want to pause.

To pause multiple displays at once:

  1. Click the round checkbox next to the display you want to pause. You can select and pause multiple displays at the same time.
  2. In the action bar that appears at the top of the Displays tab, click Pause.

Enable a paused display

To enable a paused display, click the toggle next to the paused display you want to activate. Enabling a display reinitiates collecting new content for the display, effectively making it a dynamic display again.

To enable multiple paused displays at once:

  1. Click the round checkbox next to the paused display you want to activate. You can select and enable multiple displays at the same time.
  2. In the action bar that appears at the top of the Displays tab, click Resume.

Delete a display

You can delete a display that you no longer need or want. Deleting a display removes the display code associated with the display from any posts, meaning that the display no longer has content to display (the posts are not deleted, just their association with the display).

To permanently delete a display:

  1. Note the display code of the display you want to delete.
  2. Click the toggle next to the display you want to delete.
  3. In the options that appear next to the toggle, click Delete.
  4. Remove or update any display integration code on your site that was using the display code from the deleted display.
    Tip:  If you delete a display but do not update your integration code, you do not need to worry about rendering broken images or videos. When a display does not have content associated with it, the display does not render. However, it is a good practice to remove unwanted code from your site, or update the display code to specify an active display.

To permanently delete multiple displays at once:

  1. Note the display codes of the displays you want to delete.
  2. Click the round checkbox next to the display you want to delete. You can select and delete multiple displays at the same time.
  3. In the action bar that appears at the top of the Displays tab, click Delete.
  4. Remove or update any display integration code on your site that was using the display code from the deleted displays.
    Tip:  If you delete a display but do not update your integration code, you do not need to worry about rendering broken images or videos. When a display does not have content associated with it, the display does not render. However, it is a good practice to remove unwanted code from your site, or update the display code to specify an active display.

Filter content

Content must meet the requirements of all configured filters to be included in a display. When a filter accepts multiple values, posts only need to match one value unless you configure the filter to require all values.

When creating a display, click Define content › to open the filter panel where you can choose and customize filters. Applying filters updates the content displayed in the Example Posts pane.

For details about the available filters, open the following list:

Refer to the Recommended rules topic to view a list of displays that Bazaarvoice recommends to most clients.