Add Parameters to Webpage URLs

After you find the IDs for the designation, campaign, or appeal and package 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 your organization's website.

You can add any combination of the following parameters to the end of a donation form URL, but you can only add one each. 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 a donation form, add desname=Name after desid=ID. Replace "Name" with the appropriate name for the designation.

  • appealid=ID for an appeal

  • campaignid=ID for a campaign

  • packageid=ID for a package

    Warning: When you add a package to a URL, also add the associated appeal to the URL or add the appeal in the donation form. Otherwise, when you approve a batch you will have to fix the batch exceptions.

URL Format

Tip: To save time and reduce errors, use the URL parameter builder to assemble a valid URL. This ensures the parameters are combined correctly so you don't have to manage the URL formatting rules manually.

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

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

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

    https://example.org/donate?formId=cec73394&desid=20&desname=Annual

Tip: If a designation name has spaces, %20 automatically replaces the spaces when you use the URL.

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