Add Parameters to Hosted URLs

If you are unable to place a donation form on your organization's website, you can add parameters for designation and appeal to the form's Blackbaud-hosted URL, after you find the IDs.

Note: You can add only one designation and appealto a URL.

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.

1. From Online Giving, Donation forms, select the form.

2. Select Publish.

   • For a Standard Form, select Launch form from its URL. Next, select Copy URL.

   • For an Optimized Form, select Hosted URL. Next, select Copy URL.

3. From an HTML or text editor, add parameters to the URL.

   • For a designation, add &desid=ID to the end of the URL. Replace "ID" with the designation's ID. For example,

     https://www.bb.com/donor-form?svcid=renxt&formId=8aa3b1c&desid=48923&desname=2023 General Fund

     Tip: To display a donor-friendly designation name on a donation form, add &desname=Name after &desid=ID. Replace "Name" with the appropriate name for the designation.

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

   • For an appeal, add &appealid=ID to the end of the URL. Replace "ID" with the appeal's ID. For example, https://host.nxt.blackbaud.com/adaptive-donor-form?formId=86a0c128-4364-460a-baff-5bddb1c7f3b5&envid=t-Z-FEhKwLvkGVGjTCcbBMEA&zone=usa&appealid=5