# Create Candlestick chart ### Overview Candlestick charts track financial instruments by showing open, high, low, and close prices for each period. They highlight volatility and directional trends in a compact form. ### When to use it * Displaying stock, crypto, or commodity price movements. * Analysing volatility and identifying bullish/bearish patterns. * Combining with volume or moving averages for richer analysis. Avoid candlesticks for audiences unfamiliar with financial charting or when you lack OHLC data—use line charts instead. ### Data requirements * Each category (e.g., day) must include `open`, `high`, `low`, and `close` values. * Categories should be sequential (time-based). ### Style options available | Group | Control | Input type | Options | Description | | ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | Colors | Color palette | palette | — | Palette applied to series; sets the default colours for the chart. | | General → Candlestick | Line color | color | — | Stroke colour for the series line or outline. | | General → Candlestick | Up color | color | — | Fill colour for increasing candlesticks or bars. | | General → Candlestick | Up line color | color | — | Stroke colour for the outline of increasing candlesticks. | | Axes → X Axis | Show X Axis | boolean | — | Shows or hides the X axis line, ticks, and labels. | | Axes → X Axis | Base line width | number | — | Thickness of the axis baseline line in pixels. | | Axes → X Axis | Grid line width | number | — | Thickness of gridlines in pixels. | | Axes → X Axis | Base line color | color | — | Colour of the axis baseline line. | | Axes → X Axis | Grid line color | color | — | Colour for gridlines drawn across the chart background. | | Axes → X Axis | Grid line style | select | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.). | | Axes → X Axis | Tick width | number | — | Thickness of tick marks in pixels. | | Axes → X Axis | Tick length | number | — | Length of the tick marks in pixels. | | Axes → X Axis | Tick color | color | — | Colour of the axis tick marks. | | Axes → X Axis | Allow labels to overlap | boolean | — | Allows labels to render even if they collide instead of hiding them automatically. | | Axes → X Axis | Show every n'th label | number | — | Skips labels so only every nth label is drawn. | | Axes → X Axis | Rotation of labels | number | — | Rotation angle applied to axis or data labels in degrees. | | Axes → X Axis | Type | select | category, linear, logarithmic, datetime | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime). | | Axes → X Axis | Tick placement | select | on, between | Whether ticks sit on category positions or between them. | | Axes → X Axis | Point placement | select | on, between | Positions points inside their category slot (on the tick or between ticks). | | Axes → X Axis | Opposite side | boolean | — | Positions the axis on the opposite side of the chart (top/right). | | Axes → X Axis | Margin for title | number | — | Space between the axis title and the axis labels/ticks. | | Axes → Y Axis | Show Y Axis | boolean | — | Shows or hides the Y axis line, ticks, and labels. | | Axes → Y Axis | Base line width | number | — | Thickness of the axis baseline line in pixels. | | Axes → Y Axis | Grid line width | number | — | Thickness of gridlines in pixels. | | Axes → Y Axis | Base line color | color | — | Colour of the axis baseline line. | | Axes → Y Axis | Grid line color | color | — | Colour for gridlines drawn across the chart background. | | Axes → Y Axis | Grid line style | select | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.). | | Axes → Y Axis | Tick width | number | — | Thickness of tick marks in pixels. | | Axes → Y Axis | Tick length | number | — | Length of the tick marks in pixels. | | Axes → Y Axis | Tick color | color | — | Colour of the axis tick marks. | | Axes → Y Axis | Labels alignment | select | left, center, right | Horizontal alignment of axis labels relative to the tick mark. | | Axes → Y Axis | X offset | number | — | Horizontal offset applied to axis labels. | | Axes → Y Axis | Y offset | number | — | Vertical offset applied to axis labels. | | Axes → Y Axis | Type | select | category, linear, logarithmic, datetime | Sets the vertical axis scale (category, numeric, logarithmic, or datetime). | | Axes → Y Axis | Opposite side | boolean | — | Positions the axis on the opposite side of the chart (top/right). | | Axes → Y Axis | Margin for title | number | — | Space between the axis title and the axis labels/ticks. | | Axes → Common | Font name | text | — | Font family used for titles, labels, or legend text. | | Axes → Common | Font style | text | — | Font weight or style (e.g., bold, italic). | | Axes → Common | Font size | number | — | Font size in pixels for the selected text element. | | Axes → Common | Font color | color | — | Colour of the text shown for this element. | | Axes → Axes titles | Font name | text | — | Font family used for titles, labels, or legend text. | | Axes → Axes titles | Font style | text | — | Font weight or style (e.g., bold, italic). | | Axes → Axes titles | Font size | number | — | Font size in pixels for the selected text element. | | Axes → Axes titles | Font color | color | — | Colour of the text shown for this element. | | Axes → Axes titles | X Axis margin | number | — | Extra padding around the X axis labels for titles. | | Axes → Axes titles | Y Axis margin | number | — | Extra padding around the Y axis labels for titles. | | Title → Chart title | Font name | text | — | Font family used for titles, labels, or legend text. | | Title → Chart title | Font style | text | — | Font weight or style (e.g., bold, italic). | | Title → Chart title | Font size | number | — | Font size in pixels for the selected text element. | | Title → Chart title | Font color | color | — | Colour of the text shown for this element. | | Title → Chart title | Margin bottom | number | — | Extra space below chart titles or subtitles in pixels. | | Title → Chart subtitle | Font name | text | — | Font family used for titles, labels, or legend text. | | Title → Chart subtitle | Font style | text | — | Font weight or style (e.g., bold, italic). | | Title → Chart subtitle | Font size | number | — | Font size in pixels for the selected text element. | | Title → Chart subtitle | Font color | color | — | Colour of the text shown for this element. | ### Have problems or want to improve this chart type? Ping us via . --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.chartplugin.com/how-to-create-your-first-chart/create-candlestick-chart.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.