Create a Custom Widget

Develop dynamic tools that empower partners to promote your brand. Custom widgets allow you to embed externally-hosted tools or pages directly into the impact.com interface via an iframe. Use this guide to create and configure a custom content widget that provides personalized resources and a consistent brand experience for your partners.

1

Access the custom widget creator

1. From the left navigation menu, select [Engage] → Content → Widgets.
2. In the top-right corner, select Create Widget → Custom.

2

Enter widget details

1. Enter a Name of the custom widget.
2. Optionally, enter a Description for the custom widget.
3. Optionally, enter a Label for the custom widget.
4. If required, [Toggle on] Restrict Partner Access to specify individual partners and groups that should have access to the widget.

   • Partners: Enter the name of the partners that can access the custom widget.
   • Groups: Enter the name of the groups that can access the custom widget.

3

Configure the widget

1. Select how the widget behaves from the display options:

   • Open in new tab: Opens the hosted URL in a separate tab.
   • Embed in impact.com: Displays the widget directly within the platform interface.
2. Optionally, from the Preview Image section, select Choose File to upload a thumbnail. Ensure the file is a GIF, JPG, or PNG and does not exceed 512 KB.
3. In the Widget URL field, enter the web address where your widget is hosted.
4. From the [Drop-down menu], select the protocol (e.g., https://) that matches your site's security.
5. Optionally, select [Add] Insert dynamic fields to expand the token list.
6. Locate the token you want to use and select Insert. The platform will automatically append the token (e.g., {irpid}) to your Widget URL. Refer to the Dynamic field tokens section below for a description of each token.

4

Update advanced settings

From the Language [Drop-down menu], select the language in which this widget will display.

5

Finalize the custom widget

Select Create to save your widget. Partners can find this widget in Content Widgets.

Dynamic field tokens

Token	Description
{click_url_encoded}	Click URL encoded
{click_url}	Click URL not encoded
{irimpurl}	Our impression URL
{irpid}	Partner ID
{subid1}	Partner sub ID 1
{subid2}	Partner sub ID 2
{subid3}	Partner sub ID 3
{sharedId}	Shared ID
{iradid}	Ad ID
{ircid}	Program ID
{click_url_encoded_deeplink}	Encoded click URL with appended deep link parameter.