If the call-to-action button on your partner profiles points at your own form (HubSpot, Marketo, Typeform, and so on), you can tell PartnerPage to include the partner's name or ID in that link for attribution. Your form then knows which partner the lead came from.
How it works (read this first)
Think of it like a mail merge.
You write one URL and leave a blank in it, such as
{partnerName}.You set that URL once, for the whole directory.
PartnerPage fills in the blank on every partner's page, automatically.
You do not add a URL per partner. You do not touch each partner's profile. Partners added later get it too, with no extra work.
Example. You give us this URL:
https://yourcompany.com/partner-form?partner={partnerName}On Acme Consulting's profile, the button opens:
https://yourcompany.com/partner-form?partner=Acme%20Consulting
On Globex's profile, the same button opens:
https://yourcompany.com/partner-form?partner=Globex
Nobody typed those links. PartnerPage built them from your one URL.
Setting it up
Step 1. Choose your URL. Take the link to your form and add one or more placeholders from the table below. The parameter names (partner, ref, pp_id) are yours to choose. PartnerPage only fills in the values.
Step 2. Send it to us. Email the URL to support@partnerpage.io. We set it in your directory settings, and it applies to every partner profile immediately.
Step 3. Catch the value on your form. Your form needs a hidden field that reads the value from the URL. See "Capturing the value on your form" below.
That is the whole setup.
Supported placeholders
Placeholder | What it becomes |
| The partner's PartnerPage ID. Always present and never changes, so it is the most reliable value to match on. |
| The partner's name as shown on their profile. |
| The partner's External ID, if your directory uses External IDs and this partner has one. Handy if you already track partners under your own CRM or PRM IDs. |
You can use more than one placeholder in the same URL:
https://yourcompany.com/partner-form?partner={partnerName}&pp_id={partnerId}
Capturing the value on your form
The link delivers the value to your form page. Your form still needs somewhere to store it. The usual approach is a hidden field whose name matches the parameter you chose.
HubSpot. Add a hidden field to the form, for example a single-line text property called
partner_name. Use that exact property name as the parameter in your URL:?partner_name={partnerName}. HubSpot fills hidden fields from matching URL parameters automatically.Other tools. Marketo, Typeform, Jotform, Gravity Forms and most other builders can pre-fill hidden fields from the URL. Search your tool's help for "hidden fields" or "URL pre-fill".
Optional: a different URL for one partner
Most customers only need the directory-wide URL above and can skip this section.
If you have not set a directory-wide URL, each partner profile can have its own call-to-action link instead. In the dashboard, open the partner's profile editor, find the Call to action section and enter the URL in the URL field. Placeholders work here too, and the field lists them underneath as a reminder. Partners who manage their own profile can set this from their side, unless you have chosen to manage the call to action for them.
Once a directory-wide URL is set, it takes over on every profile and the per-partner URL field is hidden.
Good to know
The header button and the button at the bottom of the profile both use the filled-in link.
Button label, open-in-new-tab, and click tracking behave exactly as before.
Values are URL-encoded for you. Names with spaces, ampersands or accents arrive intact.
If a partner has no value for a placeholder (for example no External ID), the placeholder is removed rather than left in the link.
Placeholders work in URLs that already have query parameters or a
#fragment.Placeholders are case-sensitive. Write them exactly as shown, with curly braces.
Placeholders only work in
http://andhttps://URLs.
If the URL is rejected
PartnerPage checks the URL when it is saved. Two messages can appear:
"Unsupported placeholder in the URL, only {partnerId}, {partnerName} and {externalId} are supported." Something in curly braces was not one of the three placeholders. Usual causes: a typo ({partnerid}, {partner-id}), extra spaces ({ partnerId }), or double braces ({{partnerId}}). Fix the spelling and save again.
"Placeholders are only supported in http(s) URLs." The URL does not start with http:// or https://.
Notes
Questions or want a hand setting it up? Email support@partnerpage.io.