The Give receipt shortcode outputs the donation receipt on the page donors are sent to after completing their donations.

The “Give Receipt” shortcode is used on the Give “Donation Confirmation” page found under Donations > Settings > General > Success Page:

The Success Page setting in General Settings
The Success Page setting in General Settings

The shortcode outputs the donation information for the donor to print or save once they have completed a donation.

The Give Receipt page as displayed with the give_receipt shortcode
The Give Receipt page as displayed with the give_receipt shortcode

Note: If a donation has failed or is in a pending status the donor will be brought to this page as well.

When Give is first installed, it automatically creates a “Donation Confirmation” page for you, and adds the shortcode to that page. Without this shortcode, your donors will not see a confirmation of their donation or important information about their donation history.

give_receipt

  • “company_name”
    Options:
    true/false
    Default: true
    Outputs a row in the receipt to display the company name that the donor provided during donation. The row will not appear if the value is empty.
  • “error”
    Options:
    customized text
    Default: “Sorry, it appears the viewing window for this donation receipt has expired or you do not have the permission to view this donation receipt.”
    Customize the error message if the donation ID cannot be found correctly
  • “price”
    Options:
    true/false
    Default: true
    Enable or Disable displaying the total donation amount on the receipt.
  • “date”
    Options:
    true/false
    Default: true
    Enable or Disable displaying the date the donation was made on the receipt.
  • “payment_key”
    Options: true/false

    Default: false
    Displays a unique ID which ties the donation to the specific donor profile
    “payment_method”
    Options:
    true/false
    Default: true
    Displays which payment gateway was used for that specific donation
  • “payment_id”
    Options:
    true/false
    Default: true
    Displays the unique ID of that specific transaction. This is a helpful reference for both site admins and donors in case there are any questions about specific transactions.
  • “status_notice”
    Options:
    true/false
    Default: true
    Determines whether to display a notice above the donation receipt table highlighting the status of the donation.
  • payment_status”
    Options:
    true/false
    Default: true
    Determines whether to display a row within the donation receipt highlighting the status of the donation.

The Give Receipt Shortcode Example

[give_receipt error="Oops! That didn't work!" payment_key="true" payment_method="false"]

Moving your Donation Confirmation page

If you would like to move your Donation Confirmation page, you’ll need to do two things:

  1. Move this shortcode to your new page.
  2. Update the “Success Page” setting in “Donations > Settings” and the “General” tab.

Donation Receipt versus History

A couple notes on the difference between the Donation History page and the Donation Receipt are important.

Donors who are logged-in to your site, or have used Email Access to view their Donation History will be able to see their individual donations via the Donation History page. The Donation Receipt page is where they are redirected after attempting a donation on a form.

If a donor is on the Donation History page and clicks on “View Receipt” the page will refresh and show their their individual receipt via the [give_receipt] shortcode. You do not need — or really want — to have the [give_receipt] shortcode on the same page as the [donation_history] page. Give handles that automatically for you.