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, campaign, and appeal to the form's Blackbaud-hosted URL, after you find the IDs.

Note: You can add only one designation, campaign, and appeal and package to 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 a campaign, add &campaignid to the end of the URL of a Standard Donation Form. Replace "ID" with the campaign's ID. For example, https://www.bb.com/donor-form?svcid=renxt&formId=8aa3b1c7-e4ad-4ee5-adff-e40efa81aae8&envid=t-Z-FEhKwLvkGVGjTCcbBMEA&zone=usa&campaignid=92

    • 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

    • For a package, add &packageid to the end of the URL of a Standard Donation Form. Replace "ID" with the packages's ID. For example, https://www.bb.com/donor-form?svcid=renxt&formId=8aa3b1c7-e4ad-4ee5-adff-e40efa81aae8&envid=t-Z-FEhKwLvkGVGjTCcbBMEA&zone=usa&packageid=32

      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.