JavaScript
Add the Feddy widget to any page with one script tag and send your first message.
By the end of this page your site has a support launcher, and a message sent from it shows up in your Feddy inbox.
Prerequisites
- A Feddy project and its project ID from Settings → Install. Create a project if you have none.
- A page you can edit. There is no build step and nothing to install from npm.
Install
Load the widget before the closing </body> tag:
<script src="https://core.feddy.app/sdk/feddy.js"></script>The file is a single self-contained script with no dependencies. It renders inside a shadow root, so your CSS and the widget’s never touch.
Initialize
<script>
Feddy.init({ projectId: 'fd_XXXXXXXXXXXXXXXX' })
</script>init runs once per page; later calls are ignored. If the script loads before the DOM is ready, the widget mounts on DOMContentLoaded.
The project ID ships in your page source and is public by design. Commit it. Do not put it in a secrets file or an environment variable.
Choose an entry point
By default a launcher appears bottom-right. If your site already has a Support or Feedback control, turn the launcher off and open the panel from your own element:
<script>
Feddy.init({ projectId: 'fd_XXXXXXXXXXXXXXXX', launcher: false })
document.querySelector('#help').addEventListener('click', () => Feddy.open())
</script>Verify
Open the page, click the launcher, and send a message. It appears in your Feddy inbox. Reply from the inbox; the reply shows up in the panel, and the launcher shows an unread count until the visitor reads it.
Next steps
- Identify users so replies can also reach them by email and you see who wrote in.
- Unread badge to drive your own badge from
onUnreadCountChanged. - Web SDK reference for every option and call.