Skip to main content

Display Ads


We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit to request additional support. We thank you for your patience and hope you're liking the changes!


Display ads are images, text, and/or links you can add to the upper right and lower left sidebars of your community homepage.

Annotation of left and ride sidebar

On /admin/customization/display_ads you'll see these attributes from the display ads that have been created for your community:

  • Organization ID #
  • Organization Name
  • Placement area (left or ride sidebar)
  • Body Markdown
  • Published Status (true or false)
  • Approved Status (true or false)
  • Success Rate (how often the ad is clicked)

You'll also see an edit button to edit the display ad and a destroy button to completely remove it.

How to Create a Display Ad#

Before you get started, you'll need an Organization ID # to to create the ad. If you have not created an organization yet, you can do so from your settings page. Once you've created an organization, you can look up the Organization ID # by visiting /admin/content_manager/organizations.

To create a new display ad, click the "Make A New Display Ad" button from /admin/customization/display_ads. This will bring you to a form with the following fields:

  • Organization ID: add your organization id #
  • Body Markdown: add the markdown or HTML for your ad
  • Placement Area: select left or right sidebar
  • Published (you will only see this if you are an admin)
  • Approved (you will only see this if you are an admin)

Here is an example of the body markdown from the image up top:

<a href="">
<img src="" height="300" width="300" />
<a href="">
<h2 style="text-align: center; line-height: 1.29em">Share Your Story</h2>

Display Ad Form

If you do not have publishing privileges, you'll need to ask a super admin to approve and publish your display ad.

Please note: it'll take a few minutes for your display ad or any changes made to your display ad to appear on the home page.

Additionally, if you attempt to publish a display ad and see an error, please make sure there is no space after the image source URL (i.e. between pngadd the " mark in the example above) as this can return an error.