# Report Bugs

Have you encountered an issue with Avonni Dynamic Components? We're here to help! This page explains how to report bugs effectively so we can resolve them quickly.

***

## Before Reporting a Bug

Before submitting a bug report, please try the following:

1. **Review the** [**Troubleshooting & FAQs section**](https://docs.avonnicomponents.com/dynamic-components/resources/troubleshooting-and-faq) - Most common issues have documented solutions
2. **Check the Documentation:** Review [**Release Notes Page**](https://docs.avonnicomponents.com/dynamic-components/resources/broken-reference) to ensure you're using the component correctly and that the behavior isn't expected. If not using the latest version, please update to it.
3. **Search the Community:** Check [**our Trailblazer Community Group**](https://trailhead.salesforce.com/trailblazer-community/groups/0F9KX000000iFxO0AU?tab=discussion\&sort=LAST_MODIFIED_DATE_DESC) to see if others have encountered the same issue and found a solution or workaround.
4. **Isolate the Issue:** Reproduce the bug in a *minimal, isolated environment*. Create a new, simple Dynamic Component with *only* the components necessary to demonstrate the problem. This helps us pinpoint the cause.
5. **Clear Browser Cache**: Clear your browser cache and cookies.
6. **Try on another browser**: Reproduce the issue on a different browser.

***

## How to Report a Bug

If you've gone through the troubleshooting steps and still encounter the issue, please report it by emailing us at [`support_dc@avonni.app`](mailto:support_dc@avonni.app). Include the following information in your report:

* **Subject Line:** Use a clear and concise subject line, such as: `[Bug Report] Data Table - Filter Not Working with Reactive Query`
* **Avonni Dynamic Components Version:** Specify the *exact* version number of the Avonni Dynamic Components package you are using. You can find this in Salesforce Setup > Installed Packages.
* **Component(s) Involved:** List the specific Avonni components involved in the issue (e.g., Data Table, Button, Query Data Source).
* **Steps to Reproduce:** Provide *detailed*, step-by-step instructions for reproducing the bug. Be as specific as possible. Include:
  * The exact configuration of the components involved.
  * Any relevant data source settings (queries, filters, etc.).
  * The particular actions a user takes to trigger the bug.
  * The *expected* behavior.
  * The *actual* (incorrect) behavior.
* **Screenshots/Videos:** Include screenshots or, even better, a short screen recording (e.g., Loom or Screencastify) to visually demonstrate the issue.
* **Error Messages:** If you see any error messages, include the *full text* of the message and any associated error codes.
* **Console Errors:** Include any errors from your browser's developer console (usually accessed by pressing F12).

***

### What to Expect After Reporting

1. **Acknowledgement:** We'll acknowledge receipt of your bug report within 2 business days.
2. **Investigation:** Our team will investigate the issue and attempt to reproduce it.
3. **Updates:** We'll keep you informed about the investigation's progress and any potential solutions.
4. **Resolution:** We'll address the bug in a future release of Avonni Dynamic Components. If possible, we may provide workarounds in the meantime.

Thank you for helping us improve Avonni Dynamic Components

***

## **Community Support While You Wait**

While our team investigates your bug report, you might find immediate help or workarounds in [**our Trailblazer Community Group**](https://trailhead.salesforce.com/trailblazer-community/groups/0F9KX000000iFxO0AU?tab=discussion\&sort=LAST_MODIFIED_DATE_DESC):

**Quick workarounds:** Other users may have encountered similar issues and found temporary solutions

**Confirmation from peers:** See if others are experiencing the same behavior, which helps validate the issue

**Alternative approaches:** Community members often suggest different ways to achieve your goal while avoiding the bug

**Updates and discussion:** Once we identify a fix, we often share updates in the community

Many bugs get unofficial workarounds from the community before the official fix is released. Even if you've submitted a formal bug report, posting about it in the community can help you move forward faster and help others who might encounter the same issue.

[**Join the Community**](https://trailhead.salesforce.com/trailblazer-community/groups/0F9KX000000iFxO0AU?tab=discussion\&sort=LAST_MODIFIED_DATE_DESC)