|
| 1 | +--- |
| 2 | +title: "Configure your charts" |
| 3 | +description: "Learn about the configuration options available for most chart types in Lightdash." |
| 4 | +--- |
| 5 | + |
| 6 | +Most chart types have very similar configuration options, so we put them all together below. |
| 7 | + |
| 8 | +## Layout |
| 9 | + |
| 10 | +This is where you can pick the columns from your results table that you want to plot on your x and y axes or that you want to group by. |
| 11 | + |
| 12 | +You can group by up to 3 fields in your chart. |
| 13 | + |
| 14 | +For bar charts, this is also where you have the option to stack your bars, or leave them unstacked (grouped). |
| 15 | + |
| 16 | +<Frame> |
| 17 | +  |
| 18 | +</Frame> |
| 19 | + |
| 20 | +## Series |
| 21 | + |
| 22 | +The series tab is where you can adjust how your chart shows each data series. A **data series** is a set of related data points plotted on a chart. For example, the number of new users created each day over a set of dates is a series. In a bar chart, a series is represented by bars of the same color; in a line chart, a series is represented by a single line. You can see a list of the series for your chart in the **Series** menu, and on the chart legend. |
| 23 | + |
| 24 | +<Frame> |
| 25 | +  |
| 26 | +</Frame> |
| 27 | + |
| 28 | +The options available in here will depend on the data in your chart. But, in here you can: |
| 29 | + |
| 30 | +- Set the chart type for each series |
| 31 | +- Change series labels or colors |
| 32 | +- Put series on a left or right y-axis |
| 33 | +- Show value labels or group totals on data points |
| 34 | +- Hide a series from your chart |
| 35 | + |
| 36 | +## Axes |
| 37 | + |
| 38 | +In this section you have options to: |
| 39 | + |
| 40 | +- Override the default text for your axes labels |
| 41 | +- Adjust sort order of your x-axis |
| 42 | +- Rotate x-axis labels |
| 43 | +- Set the min and max axis values for your y-axes (or keep the default auto y-axis range) |
| 44 | +- Show x-axis and y-axis grid lines |
| 45 | +- Hide x-axis completely |
| 46 | +- Hide y-axis completely |
| 47 | + |
| 48 | +<Frame> |
| 49 | +  |
| 50 | +</Frame> |
| 51 | + |
| 52 | +## Display |
| 53 | + |
| 54 | +This tab is where you're able to control the legend, reference lines, and [custom tooltips](/references/custom-tooltip) in your chart. |
| 55 | + |
| 56 | +### Reference lines |
| 57 | + |
| 58 | +You can add reference lines to your charts to easily visualize goals or thresholds. |
| 59 | + |
| 60 | +<Frame> |
| 61 | +  |
| 62 | +</Frame> |
| 63 | + |
| 64 | +To add a reference line, click `+ Add` under Display -> Reference lines. |
| 65 | + |
| 66 | +You have these options in the settings: |
| 67 | + |
| 68 | +- Select a field you want to linke to your reference line (Page views in the image above) |
| 69 | +- Set a static value (50,000 in the image above) |
| 70 | +- Add a label (`Halfway to our goal!` in the image above) |
| 71 | +- Change the line color (green in the image above) |
| 72 | + |
| 73 | +<Tip> |
| 74 | + Most reference lines are static values, but you can also use these key words to plot a dynamic value: `min`, `max`, `median`, `average`. |
| 75 | + |
| 76 | + That way your reference line will automatically update to the global min, max, median, or average of the field you selected. See image below for examples. |
| 77 | +</Tip> |
| 78 | + |
| 79 | + |
| 80 | + |
| 81 | +If you select a field plotted on your x-axis, then your line will be vertical. If you select a field plotted on your y-axis, then your line will be horizontal. |
| 82 | + |
| 83 | +<Tip> |
| 84 | + If your reference line label is cropped off your chart, try adjusting your [right margin](#margins). |
| 85 | +</Tip> |
| 86 | + |
| 87 | +### Legend |
| 88 | + |
| 89 | +You can add and adjust the legend in your chart to help people understand what data's been plotted. |
| 90 | + |
| 91 | +- Show or hide the legend |
| 92 | +- Adjust the position of the legend on your chart |
| 93 | + - The values in `position` are the coordinates of the legend on your chart. They can either be numbers or percent. We suggest using %. |
| 94 | + - If you want the position to be in the bottom right, you would set: Right = 0%, Bottom = 0%. For the legend to be in the middle of the chart, you'd set: Top = 50%, Left = 50%. |
| 95 | +- Set your legend to scroll (if you have so many groups that they overlap your chart) |
| 96 | +- Orient the values in your legened to form a list vertically, or horizontally |
| 97 | + |
| 98 | +<Frame> |
| 99 | +  |
| 100 | +</Frame> |
| 101 | + |
| 102 | +## Margins |
| 103 | + |
| 104 | +The Margin tab is where you're able to add or remove margin around the grid. Removing margin means that your chart will fill more of the space in the chart tab. Adding margin will shrink your chart into a smaller space. |
| 105 | + |
| 106 | +You can either add numbers (e.g. 50) or percent values (e.g. 50%) to the margin settings listed. The default margin is set to `top` = 70, `bottom` = 30, `left` = 5%, `right` = 5% |
| 107 | + |
| 108 | +<Frame> |
| 109 | +  |
| 110 | +</Frame> |
![mintlify[bot]](https://avatars.githubusercontent.com/in/222410?v=4&size=40){kind=avatar}
0 commit comments