Skip to main content
You can surface the partner portal directly inside your own product or website, so partners don’t have to navigate to a separate site. The primary tool for this is the in-site portal widget.

​
The portal widget

The portal widget adds a floating launcher button to your site. When a partner clicks it, the full portal opens in an embedded panel (iframe) — including login and the authenticated dashboard.
1

Connect a custom domain

The widget serves the portal from your program’s custom domain, so you must connect and verify one first. Without an active custom domain the widget can’t be enabled.
2

Add your site to the allowed domains

Add the domains where the widget may appear to the whitelist in your portal settings. The widget only initializes on pages whose domain matches the whitelist, and the same list is used to allow those pages to embed the portal (via a frame-ancestors content-security policy).
3

Enable and configure the widget

Under Program → Portal → Settings (and Portal → Widget preferences), turn on the widget and customize the launcher — title, colors, icon, position, and stacking order.
4

Install PartneroJS and load the widget

Install the PartneroJS snippet (see JavaScript tracking) and load the widget for your program:
<script>
    po('program', 'PUBLIC_PROGRAM_ID', 'portal_widget');
</script>
The widget requires an active custom domain plus at least one whitelisted domain. If either is missing, the widget will not appear even when the toggle is on. (Some admin hints mention only a subdomain — the actual requirement is a verified custom domain.)

​
Embedding the portal in your own iframe

If you prefer to place the portal in your own iframe rather than the floating launcher, the same domain rules apply:
  • By default the portal only allows itself to be framed by its own domain (frame-ancestors 'self').
  • Once the widget is enabled with whitelisted domains, those domains are added to the portal’s frame-ancestors policy, allowing them to embed it.
  • Point the iframe src at the portal’s custom-domain login URL. To smooth out the sign-in step, combine this with email prefill and auto-submit.
Embedding the authenticated portal still requires the partner to log in inside the iframe. Embedding does not bypass authentication — see prefilling the login email to reduce that friction.

​
Embeddable signup forms

Separately from the full portal, Partnero provides embeddable signup forms that can be placed in an iframe on any page (no domain whitelist needed):
  • Affiliate program signup
  • Refer-a-friend signup
  • Signup popups
These are loaded through PartneroJS and are meant for collecting new partners/members, not for showing the authenticated dashboard. See the no-code guides for details.

​
Choosing an approach

You want to…Use
Add a full portal launcher to your sitePortal widget
Place the portal in your own layout/iframeCustom iframe + whitelisted domain
Collect new signups inlineEmbeddable signup form
Reduce the login step for known usersPrefill the login email