GiveWP Progress Goal Display Short code

GiveWP Donation form:

Individual Form Goal Sort Code:

• [give_goal id="123"]

• with text: [give_goal id="123" show_bar="true" show_text="true"].

🎯 Displaying a Goal Meter in GiveWP

To display a donation goal progress meter in GiveWP, you can use shortcodes or enable the goal directly within the form settings.

✅ Step 1: Enable the Goal in the Form Settings

Before using any shortcode:

1. Go to Donations → All Forms

2. Click Edit on your desired form

3. Navigate to the Donation Goal section

4. Enable the goal

5. Set:

   • Goal amount

   • Goal format (percentage, amount, etc.)

   • Display method (progress bar, text, both)

6. Save/Update the form

The goal must be activated here for the shortcode to display correctly.

📊 Key Shortcodes for Goal Display

1️⃣ Individual Form Goal (Standalone Display)

[give_goal id="123"]

Replace 123 with your form ID.

Optional Parameters:

[give_goal id="123" show_bar="true" show_text="true"]

Options:

• show_bar="true|false" → Show/hide the progress bar

• show_text="true|false" → Show/hide the goal text (e.g., "$500 of $1000")

2️⃣ Include Goal Within the Form

To display the goal meter inside the donation form:

[give_form id="123" show_goal="true"]

This embeds the progress bar directly above or within the form layout.

3️⃣ Multi-Form Goal (Aggregate Progress)

Display total progress across multiple forms:

[give_multi_form_goal ids="123,124,125"]

This combines totals from the listed forms into one progress meter.

Using Tags Instead of IDs

[give_multi_form_goal tags="ramadan-campaign"]

This displays the combined goal progress for all forms assigned that tag.

4️⃣ Display Total Earnings (No Goal Required)

If you want to display total earnings without showing a goal:

[give_totals]

Useful for:

• Annual impact counters

• Campaign summary pages

• Transparency sections

🎨 Customization Options

🧱 Best Practice for Campaign Pages

For a dedicated campaign landing page:

1. Display a large standalone goal bar:

   [give_goal id="123" show_bar="true" show_text="true"]

2. Place the donation form below:

   [give_form id="123" show_goal="false"]

This avoids duplicating the progress bar.

⚠️ Common Issues

• Goal not showing? → Ensure it’s enabled in form settings.

• Multi-form not aggregating correctly? → Confirm forms have active goals.

• Styling issues? → Check theme CSS conflicts.