GivebearDeveloper SDK
Use window.Givebear to render widgets, open donation flows, and track embed activity.
The Givebear SDK is the developer surface for website integrations. It is served from /sdk/givebear.js and exposes window.Givebear in the browser.
Use the SDK when copied widget code is not enough. Use dashboard-generated widgets when staff only need to paste an embed.
Installation and API
Configuration reference
Analytics and versioning
SDK responsibilities
The SDK can:
- Render donation buttons, cards, and inline embeds.
- Render prayer-time widgets.
- Render calendar widgets.
- Open the donation experience.
- Track embed events.
- Auto-mount widgets from supported
data-givebear-*attributes.
The SDK does not replace payment readiness, dashboard configuration, or Stripe Connect setup. If the organization cannot accept payments in the dashboard, SDK rendering will not fix the donor payment path.
Integration model
Most integrations follow this shape:
- Load
/sdk/givebear.js. - Provide an element or selector.
- Provide organization and target configuration.
- Call the render method.
- Test the donor or attendee path.
- Add analytics only after rendering works.
Choosing between widgets and SDK
Use Widgets when the website editor can paste code and no custom behavior is needed. Use the SDK when code controls where, when, or how widgets render.