Create and run advertisements on a portal


Effective October 12, 2022, Power Apps portals is Power Pages. More information: Microsoft Power Pages is now generally available (blog)
We will soon migrate and merge the Power Apps portals documentation with Power Pages documentation.

Create text or image-based ads and have them run in multiple placements throughout your site. Randomize ads or select specific ads for specific placements. You can choose release and expiration dates for time-sensitive, scheduled content. Ads can be hyperlinked to any destination and open in the current window or a new window. Advertisements are displayed in the portal via two tables: The Ad Placement table and associated Ad table. Ads can be surfaced in many ways: with pre-made Liquid Templates available within portals via Liquid Templating/example Web Templates, or within the.aspx page via MVC actions.

Create a new advertisement

Ads represent the specific advertisement or image that will appear on the portal at a given time. The Ad table will be displayed in the location specified by the ad placement. The ad must be associated with an ad placement to appear on the portal. For this demonstration, the out-of-the-box example Place Holder ad and Sidebar Bottom ad placement will be surfaced in the Company Portal to exhibit basic functionality and to help you gain familiarity before you create more complex ads. Any of the starter sites can be used in place of the Company Portal. However, note that the Liquid Templates used for this demonstration call on the Sidebar Bottom ad placement name.

  1. Open the Portal Management app.

  2. Go to Portals > Ads

  3. Open the Placeholder ad associated with the Company Portal website (this can be done with the starter site of your choosing by selecting +New and creating an identical ad below the Website).

  4. Select the Save icon in the lower-right corner (or Save & Close in the upper-left corner if you have created a new ad).

Within the Ad form, you specify a Name to describe the ad, the Website where the ad will be displayed, and a Publishing State. Optionally you can specify a Web Template and Release/Expiration date. You must provide some sort of data for the ad to be displayed. Use the Ad table attribute table later in this guide to craft the specifics of your ad.

Create a new advertisement placements

  1. Open the Portal Management app.

  2. Go to Portals > Ad Placements.

  3. Select the Web Template Field to select a Web Template. For demonstration purposes, the Random Ad Web Template was chosen.

  4. On the rightmost corner of the Ads grid, select + to select the ad created in the previous step.

  5. Select the Save icon in the lower-right corner

When creating a new ad placement, specify a Name to describe the ad placement and the Website where the ad placement will be displayed as required. The example Web Templates that enable the use of ads as an out-of-the-box feature will be displayed within the lookup of the Web Template field in the form. These templates are also intended to be used as a source to create custom templates.

See lookup record.

Sidebar bottom settings.

Ad company portal.


The ad created above will not be displayed on the home page of the starter portal.

Using Liquid templates to place advertisements

Content managers may use Liquid to add an ad to any editable content area, as described in Work with Liquid templates and, more specifically, Ads.

This template renders an ad by name, or a random ad from an ad placement. Currently, the code below will not render multiple ads in the ad placement (that is, a rotating ad). To render multiple ads in the ad placement, you would need to build a Liquid ads API. For more information about built-in web templates, see Store source content by using web templates.

{% include 'ad' ad_name:'Name' %}
{% include 'ad' ad_placement_name:'Placement Name' %}
1. {% include 'Random Ad' placement:ads.placements[Sidebar Bottom] %}


1. {% include 'Ad Template' ad:ads{Retail Ad - Go Greene] %}


The Ad Table has the following attributes:

Name Description
Name A descriptive name for the ad
Website The associated website. Required.
Web Template The associated web templates that will be used by default to render the ad. This field is optional; if it is blank the ad will be rendered using a default template.
Release Date Controls the date and/or time after which the ad will be visible on the portal. If the ad placement is rotating through multiple ads, an unreleased ad will not appear. If no released ads are associated with an ad placement, nothing will appear. This is useful for controlling the release of time-sensitive content.
Expiration Date Controls a date or time prior to which the ad will be visible on the portal.
Publishing State The current Publishing State.
Redirect URL When the ad is clicked, the user will go to this URL. This field is optional. If no value is given, the ad will not be clickable.
Open In New Window Boolean. If set to true, the ad will open a new browser window when clicked.
Title A single line of text for the ad which can be displayed on the portal. Whether it is displayed is determined by a property on the AdPlacement control. This is primarily useful for text-based ads or simple one-line links that you want to place on the portal by using ad placements. If the title is displayed, by default it will be rendered as a hyperlink that points to the Redirect URL. This behavior may be altered by using a custom web template.
Copy A multiple-line body of text or other web content that will be displayed in the ad placement. This allows the placement to be used in a similar way to content snippets, but it is best to avoid using them to serve simply as a bucket to hold content (use snippets for that). Instead, they are best used to display rotating image or textual content.
Image URL The URL of the image that will be displayed by the ad. Optional; Use this field if you want the ad to render a static resource or a web file. The image will be clickable and link to the redirect URL, if one is given. If an ad has a note attached to it with an image file attachment, the ad will render that as its image. In this case, using the Image URL field is not necessary. See the note below regarding image attachments and the Power Platform CLI.
Image width Width of the image. This field is not required but is recommended to ensure that the rendered ad is valid and accessible HTML
Image Height Height of the image. This field is not required but is recommended to ensure that the rendered ad is valid and accessible HTML
Image Alt Text Alt Text for the image. This field is not required but is recommended to ensure that the rendered ad is valid and accessible HTML.


Image file attachments to ad records are not downloaded using the Power Platform CLI. As a workaround, use the Image URL field, or by adding an HTML reference in the Copy field to a web file record containing an image file.

See also

Configure a portal
About lists
Create and run advertisements on a portal
Gather feedback by using polls on a portal
Rate or vote on a webpage on a portal
Redirect to a new URL on a portal