Embed On Your Website
Embed the feedback, changelog or roadmap view natively on your site and sync the URL.
Installing
To put embed Featurebase on your website, just copy and paste this code into your website:
Synchronizing the URL with Your Embedded Feedback Board
Synchronizing the URL with your embedded feedback board offers a more intuitive user experience on your website. This lets users easily share specific links and ensures consistent navigation, enhancing overall site engagement and interaction.
To set this up, configure the basePath value in your embed settings to a desired path, like /feedback. This ensures your feedback board appears at the /feedback endpoint on your website.
A crucial point to remember: redirect any traffic heading to /feedback/* back to /feedback. Without this step refreshing the board will cause a 404 error.
View the below code snippets to learn how to set this up in your framework:
After this, you can test if it works by navigating to your chosen basePath + /roadmap, like example.com/feedback/roadmap. If the board loads correctly, you have successfully set up URL syncing.
Single Sign-On with embedding
Our embedded board supports automatically authenticating your users via SSO.
Generate a JWT token for the embed
Here’s a quick rundown of what you need to do:
- Log in to see your private key:
xxxxxx
Store it on your server and make sure not to share it with anyone! - When a user wants to view the Featurebase iframe, send a request to your server to generate a JWT token.
- On your server, generate a JWT token with your customer data using the example below.
- Finally, give this JWT token to the Featurebase iframe for authentication.
Install required packages
Generate the JWT token
Validate your JWT Token
Paste one of your generated tokens here to check if you did everything correctly.
You must be logged in to check if your token is valid.
Finally, pass this JWT along to the embed initialization.