Managing placements

Taboola WordPress Plugin > Managing placements

Overview

Once you have installed the Taboola WordPress Plugin, you can use it to integrate Taboola recommendations into your WordPress pages.

Select Taboola in the sidebar menu (left) to open your Taboola plugin settings.

📘

Using the settings page, you can configure the following placements:

  1. Below-article
  2. Mid-article
  3. Homepage (aka front page)

General Settings

Under General settings, fill in your Taboola publisher_id, as provided by Taboola.

📘

Your Publisher ID is a unique, alphabetic String - e.g."<<publisherID>>".

Widget Settings

Below-article widget

To display a below-article widget:

  1. Enable the widget settings, using the toggle switch provided (top, right).

    Tip: you can disable the below-article widget at your convenience (without deleting any settings), and then re-enable it later on.

  2. Fill in the widget settings:
  • Mode (aka Widget ID): The below-article mode, as provided by Taboola.
    • The mode determines the layout of your Taboola widget.
  • Placement Name: The below-article placement, as provided by Taboola.
    • The placement name displays in Taboola reporting.
    • It can optionally be used to activate specialized Taboola products and layouts e.g. Taboola Feed.
    • For more information, contact your Taboola Account Manager or Taboola Support.
  • Read More (Recommended)
  • If you would like Taboola to implement a Read More button for the article:
    1. Select the checkbox provided: Place the widget just after the article container.
    2. Verify that your below-article widget displays correctly.
    3. Contact the Taboola team to enable a Read More user experience.
  1. Click on Apply changes (bottom, right).
  2. If no errors are reported, browse to your website and verify that the widget displays correctly.

📘

Read More

Read More buttons can boost audience engagement significantly, especially on mobile devices. By shortening the viewable content, below-article units become more visible, encouraging interaction.

Mid-article widget

To display a mid-article widget:

  1. Enable the widget settings, using the toggle switch provided (top, right).

    Tip: you can disable the mid-article widget at your convenience (without deleting any settings), and then re-enable it later on.

  2. Fill in the widget settings:
  • Mode (aka Widget ID): The mid-article mode, as provided by Taboola.
    • The mode determines the layout of your Taboola widget.
  • Placement Name: The mid-article placement, as provided by Taboola.
    • The placement name displays in Taboola reporting.
    • It can optionally be used to activate specialized Taboola products and layouts e.g. Taboola Feed.
    • For more information, contact your Taboola Account Manager or Taboola Support.
  • CSS selector: A CSS selector for an element that you will target on the page. The mid-article widget will be placed just below this element.
  • Some examples:
    • To target a paragraph, fill in p.
    • To target an ID of my-id (e.g.<div id="my-id">), fill in #my-id.

      Note the leading hash character (#) in the selector, indicating that this is an ID.

    • To target a class of my-class (e.g. <div class="my-class">), fill in .my-class.

      Note the leading period (.) in the selector, indicating that this is a class.

  • Occurrence - the occurrence of the above, target element.
  • Example:
    • To target the 5th paragraph, fill in 5.

      If your selecor is unique - e.g. a unique ID - you can ignore this field.

  1. Click on Apply changes (bottom, right).
  2. If no errors are reported, browse to your website and verify that the widget displays correctly.

👍

CSS Selector

For assistance with CSS selectors, reach out via our online community, or contact Taboola Support.

Homepage (aka Front Page) widget

🚧

Homepage (aka Front Page)

The Homepage settings will be applied to the page marked as the Front Page in WordPress Admin .

To display a homepage widget:

  1. Enable the widget settings, using the toggle switch provided (top, right).

    Tip: you can disable the homepage widget at your convenience (without deleting any settings), and then re-enable it later on.

  2. Fill in the widget settings:
  • Mode (aka Widget ID): The homepage mode, as provided by Taboola.
    • The mode determines the layout of your Taboola widget.
  • Placement Name: The homepage placement, as provided by Taboola.
    • The placement name displays in Taboola reporting.
    • It can optionally be used to activate specialized Taboola products and layouts e.g. Taboola Feed.
    • For more information, contact your Taboola Account Manager or Taboola Support.
  • CSS selector: A CSS selector for an element that you will target on the page. The mid-article widget will be placed just below this element.
  • Some examples:
    • To target a section, fill in section.
    • To target an ID of my-id (e.g.<div id="my-id">), fill in #my-id.

      Note the leading hash character (#) in the selector, indicating that this is an ID.

    • To target a class of my-class (e.g. <div class="my-class">), fill in .my-class.

      Note the leading period (.) in the selector, indicating that this is a class.

  • Occurrence - the occurrence of the above, target element.
  • Example:
    • To target the 2nd section, fill in 2.

      If your selecor is unique - e.g. a unique ID - you can ignore this field.

  1. Click on Apply changes (bottom, right).
  2. If no errors are reported, browse to your website and verify that the widget displays correctly.

👍

CSS Selector

For assistance with CSS selectors, reach out via our online community, or contact Taboola Support.

Right-rail widget

Overview

The Taboola WordPress Plugin also supports a right-rail (aka sidebar) widget.

📘

This widget is configured separately to the others.

Configuration

In WordPress Admin:

  1. Select Appearance > Widgets in the sidebar menu (left).
    • This opens the WordPress interface for inserting custom widgets.
    • If the Widgets option is not present, then it is not supported by your WordPress theme.
  2. Click on the + icon (top, left) and search for "Taboola".
  3. Drag the Taboola widget to the desired position in the sidebar (right).
  4. Enter the Widget ID, as provided by Taboola.
  5. Click on Update (top, left) to save your changes.
  6. Browse to your website and verify that the Taboola widget displays correctly.

What's Next?

  1. In order to provide personalized recommendations for impressions in the EU and California, make sure to implement GDPR and CCPA respectively.
  2. If you have not already done so, configure ads.txt.
  3. Contact Taboola so that we can verify your implementation.

👍

Need a hand?

Feel free to reach out on our Community Discussion page!