Basic Widget Setup
The SimpleCommenter widget is a lightweight JavaScript snippet that adds a feedback button to your website. This guide covers the fundamental setup process.
How It Works
- You add our script to your website
- The script loads asynchronously (won't slow down your page)
- A feedback button appears for your visitors
- Visitors can submit feedback, which appears in your dashboard
Adding the Widget
Add this script tag to your website's HTML, just before the </body> tag:
<script
src="https://simplecommenter.com/js/comments.min.js"
data-id="sc_your_project_key"
defer
></script>
The defer attribute ensures the script loads without blocking your page
render. Replace sc_your_project_key with your project's public key from the
dashboard.
Required Setup
1. Create a Project
Before the widget works, create a project in the SimpleCommenter dashboard:
- Go to your dashboard
- Click "Add Project"
- Enter your project details
- Save the project, then copy its public key
2. Use Your Public Key
The data-id attribute must contain your project's public key (format sc_...) from the dashboard:
<script
src="https://simplecommenter.com/js/comments.min.js"
data-id="sc_your_project_key"
defer
></script>
The same public key works everywhere your project loads, including local development.
What Visitors See
When the widget loads, visitors will see:
- Feedback Button - A small button in the corner of the screen
- Feedback Form - Opens when clicked, with fields for:
- Comment text
- Screenshot capture (optional)
- Email (optional)
- Confirmation - Success message after submission
Next Steps
- Configure the widget with custom options
- Customize the appearance to match your brand
- Set up for specific platforms like WordPress or Shopify