The Mini Donation Widget is a compact, embeddable donation form that lets visitors give to a specific campaign directly from any page or post. No full campaign page required.

Add it to your homepage, a landing page, a sidebar, or a blog post and turn any content into a fundraising opportunity. Available in Charitable Pro 1.8.13.1+.

¿Aún no eres usuario de Charitable Pro? Regístrate hoy y obtén hasta un 50% de descuento en tu plan. Estamos seguros de que te encantará recaudar fondos con Charitable. Si, por cualquier motivo, Charitable no es adecuado para ti, te reembolsaremos tu compra con nuestra garantía de devolución de 14 días. Consigue Charitable Pro ahora »

Qué hay en esta guía

---

Características clave

The Mini Donation Widget is built to make giving fast, flexible, and friction-free. Whether you’re embedding it on your homepage, a blog post, or a landing page, every feature is designed to reduce barriers and keep donors focused on giving. Here’s what it brings to your fundraising pages:

• Place a donation widget anywhere using a Gutenberg block or shortcode
• Display preset donation amount buttons for one-time and monthly giving
• Show impact statements that update as donors select different amounts
• Optional Monthly / Give Once tabs when used with Charitable Recurring
• CTA button opens a modal or redirects to the campaign donation page
• “Other” amount input for custom giving
• Set a custom accent color, width, alignment, and widget title
• Template override support for full HTML control

Together, these features give you a fully capable donation experience in a compact, embeddable package. No dedicated campaign page required, no extra navigation, and no unnecessary friction – just a clean, focused giving experience that works wherever your audience already is.

---

Why Use the Mini Donation Widget?

Most donation plugins require donors to navigate to a dedicated campaign page before they can give. The Mini Donation Widget removes that barrier by embedding a complete giving experience exactly where your audience is already engaged: on your homepage, in a blog post, or alongside compelling content. It keeps the giving process fast, focused, and friction-free.

---

Verlo en acción

---

Requirements

• Charitable Pro 1.8.13.1 or later
• For the Monthly/Give Once recurring tab: the Charitable Recurring addon must be active

---

Empezar

Adding the Block

1. Open any page or post in the WordPress block editor.
2. Click + to add a new block and search for Mini Donation Widget.
3. Select a campaign from the Campaign dropdown in the block settings panel.
4. Configure your preferred amounts, CTA mode, and styling options in the sidebar.

Using the Shortcode

Add [charitable_mini_widget campaign_id="123"] to any page, post, widget area, or template that supports shortcodes. Replace 123 with your campaign’s post ID.

---

Configuration Options / Parameter Reference

Core Parameters

Parameter	Tipo	Predeterminado	Description
campaign_id	integer	(required)	The post ID of the campaign to donate to.
cta_mode	cadena	redirect	How the donate button behaves. redirect sends the donor to the campaign donation page; modal opens the form in a popup.
cta_label	cadena	Donate Now	The text label on the donate button.

Recurring / Tab Parameters

Parameter	Tipo	Predeterminado	Description
recurring	boolean	false	Set to true to show Monthly and Give Once tabs. Requires Charitable Recurring.
monthly_label	cadena	Mensual	Custom label for the monthly tab.
give_once_label	cadena	Give Once	Custom label for the one-time tab.

Amount Parameters

Parameter	Tipo	Predeterminado	Description
monthly_amounts	cadena	10,25,50,100	Comma-separated preset amounts for the monthly tab.
monthly_default	cadena	25	The pre-selected monthly amount. Must be in monthly_amounts.
monthly_show_other	boolean	false	Show an “Other” button allowing a custom monthly amount.
onetime_amounts	cadena	25,50,100,250	Comma-separated preset amounts for the one-time tab.
onetime_default	cadena	50	The pre-selected one-time amount. Must be in onetime_amounts.
onetime_show_other	boolean	false	Show an “Other” button allowing a custom one-time amount.

Impact Statement Parameters

Per-amount impact statements update dynamically as donors click different amount buttons.

Parameter	Tipo	Predeterminado	Description
monthly_impact_{amount}	cadena	(empty)	Impact text shown when the given monthly amount is selected. Example: monthly_impact_25="feeds a family for a month"
onetime_impact_{amount}	cadena	(empty)	Impact text shown when the given one-time amount is selected. Example: onetime_impact_100="covers school supplies for 10 kids"

Validation Parameters

Parameter	Tipo	Predeterminado	Description
min_amount	number	(none)	Minimum allowed custom amount when “Other” is enabled.
max_amount	number	(none)	Maximum allowed custom amount when “Other” is enabled.

Display Parameters

Parameter	Tipo	Predeterminado	Description
show_currency	boolean	false	Show the ISO currency code (e.g., USD) next to preset amounts.
accent_color	cadena	(theme default)	Hex color for button and accent styling, e.g., #e63946.
widget_align	cadena	center	Widget alignment: left, center, or right.
widget_width	cadena	(auto)	Max-width CSS value for the widget container, e.g., 400px or 100%.
widget_title	cadena	(none)	Optional heading above the widget. Use {{campaign_title}} to insert the campaign name dynamically.
impact_align	cadena	(none)	Text alignment for impact statements: left, center, or right.
class	cadena	(none)	Extra CSS class(es) added to the widget wrapper element.

---

Shortcode Example

[charitable_mini_widget
  campaign_id="42"
  cta_mode="modal"
  recurring="true"
  monthly_amounts="10,25,50,100"
  monthly_default="25"
  monthly_impact_10="provides clean water for a week"
  monthly_impact_25="feeds a family for a month"
  monthly_impact_50="sponsors a child's education"
  monthly_impact_100="funds a medical checkup"
  monthly_show_other="true"
  onetime_amounts="25,50,100,250"
  onetime_default="50"
  widget_title="Support {{campaign_title}}"
  accent_color="#e63946"
  widget_width="420px"
  widget_align="center"
]

---

Personalización

CSS Variable

Override the accent color globally or per instance using the CSS custom property:

.charitable-mini-widget {
    --charitable-mini-widget-accent: #e63946;
}

Template Override

To customize the widget HTML, copy the template to your theme:

yourtheme/charitable-pro/shortcodes/mini-widget.php

---

Solución de problemas

The widget is not appearing on the front end

Confirm the campaign_id is set and corresponds to a published campaign. Editors will see an error message if the ID is missing or invalid; visitors will see nothing. Check that Charitable Pro 1.8.13.1 or later is active.

The Monthly tab is not showing

The recurring tab only appears when the recurring parameter is set to true and the Charitable Recurring addon is installed and active. If Recurring is not active, the widget silently falls back to one-time mode.

Impact statements are not updating when I click an amount

Verify that the amount in your monthly_impact_{amount} or onetime_impact_{amount} keys exactly matches the value in monthly_amounts or onetime_amounts (including decimal precision). impact_50 and impact_50.00 are treated as different keys.

The widget shows a placeholder box in Divi or WPBakery

This is expected behavior in visual page builder preview mode. The widget renders correctly on the published front end.

The CTA button is not opening a modal

Ensure cta_mode is set to modal. Modal mode requires the Charitable modal/donate button functionality included in Charitable Pro.

---

Developer Resources

Hooks & Filters

• charitable_mini_widget_shortcode_output: Filters the final HTML output of the widget. Receives the HTML string and the parsed $args array.

CSS Classes

Clase	Element
.charitable-mini-widget	Root wrapper
.charitable-mini-widget__title	Optional widget title
.charitable-mini-widget__tabs	Monthly/Give Once tab bar
.charitable-mini-widget__tab--active	Currently active tab
.charitable-mini-widget__amounts	Amount button group
.charitable-mini-widget__amount--selected	Currently selected amount button
.charitable-mini-widget__amount--other	“Other” amount button
.charitable-mini-widget__impact	Impact statement area
.charitable-mini-widget__cta	Donate button

Template Override

Copy charitable-pro/shortcodes/mini-widget.php to yourtheme/charitable-pro/shortcodes/mini-widget.php to fully customize the widget markup.

---

Additional Resources

• Campaign Donate Button: single-click donate button without preset amounts
• Charitable Recurring: required for the monthly/give-once tabs
• Campaign Showcase: display multiple campaigns in a grid or carousel
• Donation Forms: full-featured inline donation forms

Not yet a Charitable Pro user? Sign up today and get up to 50% off on your plan. We’re confident you’ll love raising funds with Charitable. If, for any reason, Charitable is not the right fit for you, we’ll refund your purchase with our 14-day money-back guarantee.

Mantente conectado para más recursos para organizaciones sin fines de lucro

Para más tutoriales y vídeos adaptados a organizaciones sin fines de lucro, suscríbete a nuestro canal de YouTube. Publicamos regularmente consejos de expertos, guías paso a paso sobre donaciones en línea, estrategias de recaudación de fondos y recursos prácticos para ayudar a tu organización a tener éxito.

🗞️ Recibe consejos semanales y guías exclusivas en tu bandeja de entrada
Únete a nuestro boletín →  

🎥 Mira tutoriales paso a paso e historias de éxito
Suscríbete a nuestro canal de YouTube →  

👩🏽‍💻 Conecta con nuestra comunidad y obtén información diaria sobre organizaciones sin fines de lucro
Síguenos en LinkedIn →

🥳 Reels divertidos e información sobre organizaciones sin fines de lucro
Síguenos en Instagram → 

👀 Vídeos interesantes y divertidos para ayudarte a hacer crecer tu causa
Síguenos en TikTok→  

🌎 Suscríbete y sigue para recibir consejos generales de recaudación de fondos
Obtén consejos de recaudación de fondos en TikTok → 

Potentes recursos de recaudación de fondos

⬇️ Descarga estrategias probadas, ideas de campañas y herramientas de expertos
Obtén el Kit de Recaudación de Fondos →  

💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable →

¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable →

🏎️ Prueba Charitable
Crea tu demostración de Charitable →

Comprende la terminología y la jerga de las organizaciones sin fines de lucro
Glosario de organizaciones sin fines de lucro→

% ¿Buscas ofertas y descuentos para organizaciones sin fines de lucro?
Las mejores ofertas y descuentos para organizaciones sin fines de lucro →