Skip to main content
By the end of this page your site will have a chat button that opens Feddy on every page, and a message sent from it will be sitting in your inbox. It takes about five minutes.

​
Before you start

  • A Feddy project and its project ID. You’ll find the ID under Settings → Install in the dashboard. No project yet? Create one first.
  • Access to your theme’s files, or the ability to add a plugin. Nothing to install from npm; the widget is one script loaded from Feddy’s servers.
1

Add the script

Add this to your theme’s functions.php. If you’d rather not touch the theme, the same lines work in a small plugin file:
functions.php
Two details worth knowing: the final true places the script at the bottom of the page so it never slows down your content, and null as the version stops WordPress from adding its own cache-busting suffix, so browsers cache the file the way Feddy intends.
The project ID isn’t a secret. It’s visible in your page source, so anyone can find it, and that’s fine: it only tells Feddy which inbox a message belongs to. Commit it like any other setting. There’s nothing to protect, so keep it out of your secrets file.
2

Choose how users open it

By default, a floating chat button appears in the bottom-right corner of every page. If you’d rather open Feddy from a menu item or button, pass launcher: false to init and add a click handler that calls Feddy.open().
3

Send yourself a message

Open the site, click the button, and send a message. Then open your inbox at dash.feddy.app: it’s there, with the page URL and browser alongside.Reply from the inbox. Back on the site, the reply appears in the panel.
That’s the whole loop: a visitor writes in, you answer, and the answer reaches them on your site.

​
Next steps

Identify users

Tell Feddy who’s logged in, so you see their name in the inbox and replies can reach them by email.

Unread badge

Show the count on your own element when you’ve turned the floating button off.

Conversations

What you’re looking at in the inbox, and what happens on its own.

Web SDK reference

Every option and call in the widget.