Add Parameters to Webpage URLs

After you find the IDs for the designation or appeal you want to track for a donation form, add them to the URL of the webpage where:

  • the Standard Donation Form is embedded.

  • the Optimized Donation Form is launched from a hyperlink or button.

    Note: Optimized Forms are not embeddable like Standard Forms. Only the Optimized Loader Script can be embedded on a webpage or the root of the website.

You can add any of the following parameters to the end of a donation form URL, but you can only add one each to a URL. If you build the URL manually, replace "ID" with the appropriate ID. You can find the IDs in the URL parameter builder.

  • desid=ID for a designation

  • desname=Name for a donor-friendly designation name

    Note: To display the designation's name on the donation form, add desname=Name after desid=ID. Replace "Name" with the appropriate name for the designation.

  • appealid=ID for an appeal

URL Format

  • If the base URL does not contain a ?, then include a ? before the first parameter and an & before other parameters.

    http://example.org/donation?desid=20&desname=Annual

  • If the base URL does contain a ?, include an & before all parameters.

    https://host.nxt.blackbaud.com/adaptive-donor-form?formId=cec73394&desid=20&desname=Annual

Tip: If the designation name has spaces, %20 automatically replaces the spaces when you use the URL. You don't have to add %20 manually within the space unless you prefer to.

Note: If the webpage contains multiple donation forms, the URL parameters override any designation or appeal configured within the forms.