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 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

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 or appeal configured within the forms.