The CharityStack hosted script lets CharityStack experiences load on your organization's website.
When To Use This
Install the hosted script before using embedded forms, overlay buttons, Add to Cart, Supporter List, Fundraising Bar, Fundraising Flag, or other website elements on your organization's site.
Hosted pages do not need the hosted script because they are served by CharityStack. QR codes and prefilled links also do not need the script unless they point to an embedded experience on your website.
Before You Start
You need access to edit your website or website builder.
You need permission in CharityStack to view Settings.
Your website should support custom code or script installation.
Your website URL should be saved in Settings > Organization before testing overlays or website-based experiences.
Steps
Go to Settings.
Open Embed.
Copy the CharityStack hosted script.
Add the script to your website according to your website builder's custom code instructions.
Publish the website change.
Return to CharityStack and use Verify installation with the page URL where the script was added.
After the hosted script is installed, add the form or element code for the specific experience you want to display.
Notes
Most websites need the hosted script once on the site template, global header, or specific page where CharityStack experiences will appear. Each embedded form or element still has its own code that belongs where the experience should render.
If your website builder has separate areas for header code and page body code, place the hosted script in the header or site-wide custom code area. Place form and element code in the page section where the embedded experience should appear.
Avoid installing duplicate copies of the hosted script on the same page. Duplicate scripts can make embedded elements harder to troubleshoot.
Website builders handle custom code differently. If verification fails, confirm that the script was published, the page URL is public, and your website plan allows custom scripts.
If a form or element still does not appear after verification succeeds, confirm the individual form or element code was copied from the correct active record.
Troubleshooting
If Verify installation cannot find the script, confirm the script is on the same URL you entered.
If the page was just published, wait a few minutes and try verification again.
If your website uses caching, clear the cache or publish the page again.
If an embedded experience is blank, confirm both the hosted script and the individual element code are present.
If the website editor strips scripts, ask your website admin or developer to add the script through the site's approved custom code area.
During onboarding, CharityStack may guide you through script installation before you publish your first form. Outside onboarding, you can return to Settings > Embed whenever you need the script.
Related
