Prerequisites
Before getting started, you’ll need:- A paid Wix plan (Light, Core, Business, or Business Elite)
- A custom domain connected to your Wix site
- A Givebutter account with at least one published campaign
- Your Givebutter Account ID and Widget ID
Widget Types Available
Button Widget
Static or Floating buttons that trigger donation forms when clicked
Form Widget
Complete donor-friendly donation interfaces embedded on your page
Goal Bar
Real-time campaign progress displays
Signup Form
Capture donor information for your mailing lists
Supported Payment Methods
Donors can use multiple payment methods:- Credit and debit cards
- PayPal
- Venmo (desktop only)
- Google Pay
- ACH transfers (if enabled)
- Donor-Advised Funds (DAF)
Note about Apple Pay: Apple Pay will not appear in embedded widgets due to limitations set by
Apple that prevent it from being used in iFrames.
Installation
1
Get Your Library Code and Widget ID
- Log into your Givebutter dashboard
- Navigate to Settings → Developers → Widgets
- Click the Wix button
- Copy your Library Code (Server URL)
- Go to your campaign’s Sharing tab → Widgets → Embed
- Copy your Widget ID (shown in green in the code)
2
Add Custom Element in Wix
- Open your Wix site editor 2. Click the blue + (plus) button to add elements 3. Navigate to Embed Code → Custom element 4. Click on the custom element box that appears on your page
3
Configure the Custom Element
- Click Choose Source 2. In the popup, enter: - Server URL: Paste your library code from
Givebutter - Tag name:
givebutter-widget3. Click Apply
4
Set Widget Attributes
- Click Set Attributes 2. Click Add Attribute 3. Enter: - Attribute name:
id- Value: Your Widget ID from Givebutter 4. Click Apply
5
Publish Your Site
- Position the widget where you want it on your page
- Click Save in the top right
- Click Publish to make your changes live
Finding Your Widget ID
Where is my Widget ID?
Where is my Widget ID?
- Go to your campaign’s Sharing tab in Givebutter
- Click Widgets
- Select the widget type you want
- Click Embed
- Your Widget ID appears at the top of the popup or highlighted in green within the code
<givebutter-widget id="abc123">, your Widget ID is abc123Widget Customization
Positioning Floating Buttons
By default, floating buttons appear in the lower-right corner. To move them to the lower-left:- Click Set Attributes on your custom element
- Click Add Attribute
- Enter:
- Attribute name:
position - Value:
bottom-left
- Attribute name:
- Click Apply
bottom-right(default)bottom-left
Hiding Widgets on Specific Pages
If you want to hide a floating widget from specific pages:- Go to Settings → Custom Code in Wix
- Add this CSS to the page-specific code:
YOUR_WIDGET_ID with your actual Widget ID.
Making Widgets Appear Site-Wide
To display a widget across all pages:- Add the widget to your site’s header or footer
- This makes it visible on every page automatically
- Particularly useful for floating button widgets
FAQ & Troubleshooting
Widget Appears Cropped in Preview
Widget Appears Cropped in Preview
This is normal behavior in the Wix preview. The widget will display properly on your published, live site. Always test on your live site after publishing to see the true appearance.
Widget Only Appears on One Page
Widget Only Appears on One Page
If your widget should be site-wide but only shows on one page: - Move the custom element to your
site’s header or footer - This ensures it displays across all pages - Floating button
widgets work best when added site-wide
Widget Doesn't Load
Widget Doesn't Load
Check these items: - You’re on a paid Wix plan (not free) - Server URL is correctly entered
(your library code) - Tag name is exactly
givebutter-widget (lowercase, hyphenated) - Widget ID
attribute is correct - Campaign is live and published in GivebutterPayment Methods Missing
Payment Methods Missing
If certain payment methods don’t appear: - Verify they’re enabled in your Givebutter account
settings - Remember Apple Pay won’t work in embedded widgets - Venmo is desktop-only
Campaigns Must Be Published
Campaigns Must Be Published
Your campaigns must be live and published in Givebutter before they can be embedded as widgets. Draft campaigns will not work.
Important Notes
Widgets Update Automatically: Changes made to your campaign in the Givebutter dashboard
automatically update in your embedded widgets—no need to re-embed or update code.
Next Steps
Widget Examples
See live examples of all widget types
URL Prefill
Pre-fill donation forms with donor information
Analytics
Track widget performance and attribution
Widget Types
Learn about different widget configurations
Need Help?
- Wix Support: Contact Wix support for custom element issues
- Widget Questions: Email [email protected]
- General Help: Visit help.givebutter.com