---
title: "Get started with Custom Reports"
canonical: "https://support.appfire.com/space/RDD/1528825149/Get%20started%20with%20Custom%20Reports"
format: markdown
---
> Macro (aura-html)


## Save and publish your report

1. Use the live **Preview** panel to review the final output.
2. Click **Save,** and your report is ready to be [shared](https://appfire.atlassian.net/wiki/label/RDD/sharing) with your colleagues.

## Troubleshooting common issues

1. Error: Cannot connect to datasource:
  - Double-check the API URL and ensure it uses HTTPS.
  - Verify your authentication credentials and token expiration.
2. Visualization problems:
  - Ensure all required fields are correctly mapped in the visualization editor.
3. Use the **[Debug Mode](https://appfire.atlassian.net/wiki/spaces/RDD/pages/1549304032/Query+and+transform+your+data+with+JSONata#Debug-Mode)** (toggle in the editor toolbar) to inspect data and ensure the JSON structure matches the visualization requirements.

## Advanced knowledge

To move to the next level of Custom Reports, you should learn:

- **[JSONata](https://jsonata.org/)**: JSON query and transformation language.
- **CSS**: To style your reports.
- **[Recharts](https://recharts.org/en-US/)**: The composable charting library built on React components behind our charts.

## Next steps

> Macro (children)