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:

Filter Details
Author Name / Handle

Description: Limits to content from specified authors or to content that does not contain the specified authors.

Accepts multiple values: Yes.

Options: You can add authors manually or in bulk:

  • Manually—Select Any to limit posts to content from specified authors, or select Exclude to limit posts to content that does not contain the specified authors. You can add one or more authors for this filter. Type the author's username (for example, "double_r_diner") or friendly display name (for example, "Double R Diner") and hit enter to add it. This is a case-sensitive field. Repeat to add additional authors.
    Tip:  The filter dropdown prepopulates author usernames for active sources that collect content based on author name. The dropdown does not prepopulate author usernames for inactive sources or sources collecting content based on criteria other than author name, nor does it prepopulate friendly display names, but you can search for these options rather than selecting them from the dropdown menu.
  • Allow bulk paste—Enable this option to paste a comma-separated list of authors. To create and paste the list:
    1. Create an Excel file.
    2. Enter the values you want to paste within a column. For example, if you want to paste the values "American football", "Brazilian jiu-jitsu", and "Cycling", enter the values as follows:
      Note:  Enter more than one word within a single cell if you want to enter a multi-word phrase. However, do not include a comma within a cell because the phrase would be split by the comma.
      A
      1 American football
      2 Brazilian jiu-jitsu
      3 Cycling
    3. In a blank cell outside the column, enter the formula =TEXTJOIN(",",TRUE,A:A) (where A represents the name of the column that contains your values) to create one cell containing all the values separated by commas.
    4. Copy the cell of comma-separated values.
    5. Back in Curations, paste the values into the text box.
    6. Hit enter.
Author Permission

Description: Filters content based on author permission status.

Accepts multiple values: Yes.

Options: You can select one or more of the following statuses for this filter:

  • Bypassed—the author permission process will not execute, meaning no permission requests have been or will be sent.
  • Uninitiated—the permission process hasn't been initiated, likely because a trigger event (like approval in moderation) hasn't occurred.
  • Queued—a permission request messages is scheduled but has not yet been sent.
  • Sent—a permission request message was sent, but the author has yet to respond.
  • Approved—the author accepted the terms and granted permission for content use.
  • Spam—the permission request message was removed, either because it was marked as spam by Twitter or Instagram or the author removed it from the post.
  • Followup—the content author responded with anything other than the acceptance term.
    Note:  The author must respond directly to your company's social media account or message (meaning the author includes "@yourCompanyName" in their message).
  • Expired—the content author did not respond within 30 days of receiving the permission request.
Authors in Photos

Description: Filters Instagram content based on the authors tagged in a photo.

Accepts multiple values: Yes.

Options: You can add one or more authors for this filter. Type the author name and hit enter to add it. Repeat to add additional authors. Choose one of the following options:

  • With any of these—limits to posts that tag one or more of the authors provided.
  • With all of these—limits to posts that tag every author provided.
  • With author in photo—limits to posts that tag at least one author. This selection does not require an author input.
  • Without Author in photo—limits to posts that do not tag any author. This selection does not require an author input.
 
Channels

Description: Filters content based on its social channel.

Accepts multiple values: Yes.

Options: You can select one or more of the following channels:

  • Instagram
  • Twitter
  • Flickr
  • Pinterest
  • Tumblr
  • Vimeo
  • YouTube
  • Custom
 
Date Published

Description: Limits to content published during the specified period.

Accepts multiple values: No.

Options: Select a start and end date. The most recent end date you can select is 1 week prior to the current date.

 
Labels

Description: Limits the impact to content with any, all, or none of the specified labels.

Accepts multiple values: Yes.

Options: You can add one or more labels for this filter. Type the label and hit enter to add it. Repeat to add additional labels. Choose one of the following options:

  • With any of these—limits to posts that contain one or more of the labels provided.
  • With all of these—limits to posts that contain every label provided.
  • With label—limits to posts that contain at least one label. This selection does not require a label input.
  • Without label—limits to posts that do not contain any labels. This selection does not require a label input.
 
Product IDs

Description: Limits to content with any, all, or none of the specified product IDs.

Accepts multiple values: Yes.

Options: You can add one or more product IDs for this filter. Type the product ID and hit enter to add it. Repeat to add additional product IDs. Choose one of the following options:

  • Any—limits to posts that contain one or more of the product ID tags provided.
  • All—limits to posts that contain every product ID tag provided.
  • Exists—limits to posts that contain at least one product ID tag. This selection does not require a tag input.
  • Doesn't exist—limits to posts that do not contain any product ID tags. This selection does not require a tag input.
 
Featured Posts Description: Filters content based on the presence or absence of a feature flag.

Accepts multiple values: No.

Options: You can select one of the following options:

  • Don't filter by featured content—does not apply any filtering based on feature status.
  • Featured—limits to posts marked as featured content.
  • Not featured—limits to posts not marked as featured content.
 
Displays

Description: Limits to content with any, all, or none of the specified display tags.

Accepts multiple values: Yes.

Options: You can add one or more display tags for this filter. Type the tag and hit enter to add it. Repeat to add additional display tags. Choose one of the following options:

  • Any—limits to posts that contain one or more of the display tags provided.
  • All—limits to posts that contain every display tag provided.
  • Exists—limits to posts that contain at least one display tag. This selection does not require a tag input.
  • Doesn't exist—limits to posts that do not contain any display tags. This selection does not require a tag input.
 
Moderation Status

Description: Filters content based on its moderation status.

Accepts multiple values: Yes.

Options: You can select one or more of the following statuses for this filter:

  • Uninitiated—posts that have had no moderation activity.
  • Approved—posts approved through manual or Bazaarvoice moderation.
  • Rejected—posts rejected through manual or Bazaarvoice moderation.
  • Sent—the permission request was sent, but the author hasn't replied.
  • Pending—the permission request was sent, but the author hasn't replied.
 
Moderation Tags

Description: Filters content based on its moderation tags.

Accepts multiple values: Yes.

Options: You can select one of the following options for this filter:

  • With any of these—the post contains any of the tags specified in the text box. You can add multiple terms or keywords by entering the value and pressing enter. Repeat to add multiple values.
  • With all of these—the post contains all of the tags specified in the text box. You can add multiple terms or keywords by entering the value and pressing enter. Repeat to add multiple values.
  • With moderation tag—the post contains a moderation tag.
  • Without moderation tag—the post does not contain a moderation tag.
 
Languages

Description: Filters content by language.

Accepts multiple values: Yes.

Options: You can add one or more languages for this filter. Scroll to find the language or type it to narrow the options. Select the language to add it. Repeat to add additional languages.

You can also select to filter by Unsupported Languages (posts in languages that you cannot filter on individually) and Undetected Languages (posts in languages that cannot be identified). For example, it may be useful to search for posts in English, but also for posts in undetected languages, which may include posts with little to no text, or posts comprised of emojis.

 
Media Type

Description: Limits to content containing a video or photo.

Accepts multiple values: Yes.

Options: You can select one or more of the following options:

  • Has photo—posts containing a photo.
  • Has video—posts containing a video.
  • Has photo or video—posts containing a photo or video.
  • Text Only—posts that do not contain photos or videos.

Tip: This filter is useful for removing text-only posts from your collection or view.

 
Text

Description: Limits to posts containing any, all, or none of the specified keywords.

Note:  The search matches on full words only, and abides by the following rules:
  • If you provide a root word, such as a singular noun or unconjugated verb, the search matches all forms of the root word, including plurals and verb tenses.
  • If you provide a plural word, the search matches the plural and singular forms of the word.
  • If you provide a variation of the word that is not plural, such as a verb tense or alternate noun, the search matches the exact variation (and its plural, if applicable) only.
  • If you provide a phrase instead of a word, the search returns partial matches, but the result must start with the first word of the phrase.
Refer to the following table for examples of text filtering.

Query Matches Does Not Match
hit hit, hits, hitting hitman
wonder wonder, wonders, wondering, wondered WonderKid
wondering wondering wonder, wonders, wondered
house house, houses, housing, housed thisHouseRocks!
housing housing house, houses, housed
win win, wins, winning, won BigWin
wins win, wins winning, won
winning winning, winnings win, wins, won
sweet potato fry sweet potato fry, sweet potato fryeees unsweet potato fry, sweet potato fries
sweet potato fr sweet potato fry, sweet potato fryeees, sweet potato fries unsweet potato fry, sweet potato chips

Accepts multiple values: Yes.

Options: Configure the filter to apply when:

  • Any—the post contains one or more of the specified terms.
  • All—the post contains all specified terms.
  • Exclude—the post does not contain the specified terms.

You can enter words manually or in bulk:

  • Manually—You can add multiple terms or keywords by entering the value and pressing enter. Repeat to add multiple values.
  • Allow bulk paste—Enable this option to paste a comma-separated list of words. To create and paste the list:
    1. Create an Excel file.
    2. Enter the values you want to paste within a column. For example, if you want to paste the values "American football", "Brazilian jiu-jitsu", and "Cycling", enter the values as follows:
      Note:  Enter more than one word within a single cell if you want to enter a multi-word phrase. However, do not include a comma within a cell because the phrase would be split by the comma.
      A
      1 American football
      2 Brazilian jiu-jitsu
      3 Cycling
    3. In a blank cell outside the column, enter the formula =TEXTJOIN(",",TRUE,A:A) (where A represents the name of the column that contains your values) to create one cell containing all the values separated by commas.
    4. Copy the cell of comma-separated values.
    5. Back in Curations, paste the values into the text box.
    6. Hit enter.
 
Location

Description: Limits to posts based on a search radius.

Accepts multiple values: Yes.

Options: You can select using the following option:

Filter within a search radius (meters)—the post is within a specified search radius (in meters) of the map marker. To set the location of the map marker, allow your browser to know your location, or click the desired location on the map.

Note: This option limits posts to sources tagged with location data, which at present means only Twitter and Instagram.

 

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