--- title: "GiveWP Totals Shortcode" source: "https://docs.nexcess.com/software/give/give_totals/" description: "The [give_totals] shortcode allows you to display the earnings from multiple forms on your site. Multiple goals can be rolled into one and displayed with or wit…" vertical: "Software" area: "Give" date: "2018-04-25" last_modified: "2026-07-02" --- # GiveWP Totals Shortcode The `[give_totals]` shortcode allows you to display the earnings from multiple forms on your site. Multiple goals can be rolled into one and displayed with or without a progress bar. This documentation walks you through the various options and attributes that can be included there. You may need to display the total current progress of a given form or collection of forms whether they have a progress bar enabled on them individually or not. The `[give_totals]` shortcode is made to enable you to do exactly that. You can display a combined total of any number of forms by listing their IDs, or by category or tag. You can additionally show a progress bar based on any total amount you designate with your own custom messaging as well. This is a very useful, practical, and flexible shortcode that you’ll find many uses for. ![Screenshot showing the GiveWP shortcode builder modal open, with the give_totals options shown clearly.](https://docs.nexcess.com/wp-content/uploads/2026/06/give_totals_shortcode_builder-1024x611-1.png)The give\_totals options within the GiveWP shortcode builder modal.## Using the Shortcode Builder with give\_totals The GiveWP shortcode builder allows you to generate the shortcode to your exact specifications. Within the builder you’ll have the following options: - **Donation Form IDs:** Use this to list your GiveWP form IDs that you want to combine for the total. IDs must be comma separated. - **Shortcode attribute:** `ids` - **Attribute values:** numerical values only, comma-separated. - **Total Goal:** Set any numerical value you want as your total goal amount. - **Shortcode attribute:** `total_goal` - **Attribute value:** any numerical value you would like. - **Message:** This is the inline text message to display your totals. - **Shortcode attribute:** `message` - **Attribute value:** Any text you would like. To display the dynamic information of the total and the goal use `{total}` and `{total_goal}` respectively. - **Link:** If this is filled with a URL, a hyperlink will appear to encourage readers to go and donate. - **Shortcode attribute:** `link` - **Attribute value:** Any full URL, including “https://” and/or “www” if necessary. - **Show Progress Bar:** This will output a progress bar, styled like our GiveWP progress bars. If you choose to show it, it will appear regardless of whether your forms have a progress bar enabled individually or not. - **Shortcode attribute:** `progress_bar` - **Attribute values:** `true` (default), `false` ## Additional GiveWP Totals Shortcode Attributes There are some additional attributes that are not exposed in the shortcode builder that can be powerful as well: - **Categories:** Display totals of a whole category or categories of forms. - **Shortcode attribute:** `cats` - **Attribute values:** A comma separated list of GiveWP form category ids that you want to combine into one total. - Tags: Display totals of all forms with specific tags. - **Shortcode attribute:** `tags` - **Attribute values:** A comma separated list of GiveWP form tag ids that you want to combine into one total. ## Example Give\_Totals Implementations Here are some detailed examples of ways you can implement the GiveWP Totals feature with the shortcode either manually or via the Shortcode Builder: ### EXAMPLE: Default Output None of the shortcode attributes are technically “required.” If you simply type `[give_totals]` into a page or post, you will get the following example: ![The give_totals default output](https://docs.nexcess.com/wp-content/uploads/2026/06/give_totals_default_output.png)Note that because the `total_goal` is not set the message is awkward. With that in mind, it’s best to either set a goal with the `total_goal` attribute, or set a message (with the `message` attribute) that does not include the `{total_goal}` dynamic output. Note also that though the `progress_bar` default is “true” it cannot be displayed above because there is no total for the progress to be compared against. ### EXAMPLE: Basic Configuration This is an example of a very basic configuration with only the `total_goal` attribute configured. ![The output of the give_totals shortocde with the total_goal being set at $50,000. This now properly shows a progress bar with its progress and the total goal amount.](https://docs.nexcess.com/wp-content/uploads/2026/06/give_totals_basic_configuration_output.png)Note how this adds the progress bar and the amount raised now makes sense in the context of the goal set. ### **EXAMPLE: Text only within a Cover Block** Because the output of the totals is very simple, it can be used in a wide variety of ways to great effect. Below is an example of embedded the totals within a “[Cover block](https://wordpress.org/support/article/cover-block/)“. ![The totals displayed within a cover block with the message: Thanks to you, we’ve raised $6,309 across all our congregations combined! Let's keep it up!](https://docs.nexcess.com/wp-content/uploads/2026/06/EXAMPLE_-Styled-no-Progress-Bar-1024x578-1.png)### **EXAMPLE: Text only of Totals + Custom Message** If you’d like to have quick display total of all of your forms via text with a custom message, use this shortcode and edit the custom message to your liking. Be sure to include the “{total}” in your message. ![GiveWP totals shortcode with block of text only for all donation forms](https://docs.nexcess.com/wp-content/uploads/2026/06/give-totals-text-message-only.png)