Report a Bug
Found a bug in BreakMade? Help us fix it by submitting a detailed report.
Found something not working correctly? Bug reports help us improve BreakMade for everyone. The more detail you provide, the faster we can fix the issue.
How to Report a Bug
Via Contact Form
- Visit our contact page
- Select “Bug Report” as the topic
- Fill out the bug report details
- Include screenshots if possible
- Submit the form
What to Include
Required Information
- BreakMade Version: Found in BreakMade settings
- WordPress Version: Found in Dashboard → Updates
- Breakdance Version: Found in Breakdance → About
- PHP Version: Found in Tools → Site Health → Info
Bug Description
- What happened: Describe the unexpected behavior
- What should happen: Describe the expected behavior
- Steps to reproduce: List exact steps to recreate the issue
Environment Details
- Browser: Chrome, Firefox, Safari, Edge + version
- Operating System: Windows, macOS, Linux + version
- Hosting Provider: If known
- Active Plugins: List other active plugins
Bug Report Template
Copy and use this template:
## Bug Report
**BreakMade Version:**
**WordPress Version:**
**Breakdance Version:**
**PHP Version:**
### Description
[What went wrong]
### Expected Behavior
[What should have happened]
### Steps to Reproduce
1.
2.
3.
### Environment
- Browser:
- OS:
- Hosting:
### Screenshots
[Attach any relevant screenshots]
### Additional Context
[Any other relevant information]
Finding Version Information
BreakMade Version
- Go to WordPress Admin
- Navigate to BreakMade
- Version shown in the header or footer
WordPress Version
- Go to Dashboard → Updates
- Version shown at the top
Breakdance Version
- Go to Breakdance → About
- Or check the Breakdance header in settings
PHP Version
- Go to Tools → Site Health → Info
- Expand “Server” section
- Find “PHP version”
Common Issues
Before Reporting
Check if your issue matches these common scenarios:
Colors Not Syncing
- Check “Do Not Sync Colors” is disabled
- Clear all caches
- Re-save the palette
Variables Not Working
- Verify BreakMade CSS is enabled
- Check for typos in variable names
- Clear browser cache
HeadSpin Mode Issues
- Ensure HeadSpinUI is active
- Re-run data merge
- Check for unconverted variables
Styles Not Appearing
- Clear WordPress cache
- Clear CDN cache
- Refresh Breakdance editor
- Check for CSS conflicts
After Submitting
What Happens Next
- Acknowledgment: We’ll confirm receipt of your report
- Investigation: Our team investigates the issue
- Reproduction: We attempt to reproduce the bug
- Fix: If confirmed, we work on a fix
- Release: Fix included in next update
- Notification: You’re notified when fixed
Response Times
- Critical Bugs: Within 24-48 hours
- Standard Bugs: Within 1 week
- Low Priority: Addressed in regular update cycle
Temporary Workarounds
While waiting for a fix, you might try:
- Disable conflicting plugins: Temporarily disable other plugins
- Use alternate method: Check docs for alternate approaches
- Custom CSS: Apply manual CSS as temporary fix
- Previous version: Rollback to last working version
Known Issues
Check our changelog for known issues in the current version.
Security Issues
If you’ve found a security vulnerability:
- Do NOT post publicly
- Email directly to: support@breakmade.com
- Include “SECURITY” in subject line
- We’ll respond within 24 hours
Security issues are treated with highest priority.