---
title: "Configuration"
canonical: "https://support.appfire.com/space/RDD/560661458/Configuration"
format: markdown
---
## Configuration

Three main steps are required to configure your gadget:

1. Name your gadget meaningfully, so everyone knows at a glance what it is about and when to use it.
2. Fill out the remaining fields as applicable.
3. Finally, indicate if you want to use the current settings for all the compatible gadgets in the dashboard. This option eases the pain of configuring one by one the remaining gadgets with the same default configuration.

| **Field** | **Description** |
| --- | --- |
| Datasource | Where the source Jira instance is installed. |
| JQL query or filter | The JQL query filters through the list of issues (see the [JQL documentation](https://support.atlassian.com/jira-software-cloud/docs/use-advanced-search-with-jira-query-language-jql/)).  
Note that if you dont select any filter, the gadget requests all  the content in the source instance resulting in performance issues.   
We recommend to add at least one filter.  
**EXAMPLE**  
To list all the issues of the project Teams in Space use the clause `project = "TIS”`.   
**NOTE**  
The gadget returns the results of the query, which are not fixed and could change over time. |
| View type | This parameter indicates the visual representation of the JQL query results:  
Table, line chart, tile chart, pie chart, bar chart, grouped bar chart, stacked bar chart or multi line chart. |
| Chart by | This parameter selects the x-axis value, in other words, what you see in the horizontal axis.   
These values or concepts are shown in the chart legend. |
| Type | This chart parameter indicates what type of aggregation you can apply to the **field** parameter:   
Count, sum, max, min, mean.  
For more info, check the [aggregations](https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309431/JQL+Custom+Charts#Aggregations) section. |
| Field | This parameter selects the y-axis values (vertical axis).  
Focus on what you want to count (or any other aggregation) and plot in the chart. |
| Columns | This field (just for the table view) appears in the list that displays the search results.  
Drag and drop to reorder the columns. |
| Group results by selected columns | This field allows you to group the results of a query by the previously selected columns.  
The resulting rows are split into** **groups, based on their values.  
Check the [group results](https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309431/JQL+Custom+Charts#Group-results) section. |
| Aggregations | This field allows you to do calculations in the table view.   
Count, sum, max, min, mean- over the results. Check the [aggregations](https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309431/JQL+Custom+Charts#Aggregations) section. |