<p>To insert a chart in the <ahref="https://www.onlyoffice.com/document-editor.aspx"target="_blank"onclick="onhyperlinkclick(this)"><b>Document Editor</b></a>,</p>
<pclass="note"><b>Note</b>: <b>ONLYOFFICE Document Editor</b> supports the following types of charts that were created with third-party editors: <b>Pyramid</b>, <b>Bar (Pyramid)</b>, <b>Horizontal/Vertical Cylinders</b>, <b>Horizontal/Vertical Cones</b>. You can open the file containing such a chart and modify it using the available chart editing tools.</p>
<li><imgalt="Number format"src="../../../../../../common/main/resources/help/en/images/numberformat.png"/> for changing the number format, i.e. the way the numbers you enter appear in cells</li>
<li><imgalt="Chart Type"src="../../../../../../common/main/resources/help/en/images/charttypebutton.png"/> for choosing a different type of chart.</li>
Use the <b>Chart Data</b> dialog to manage <b>Chart Data Range</b>, <b>Legend Entries (Series)</b>, <b>Horizontal (Category) Axis Label</b> and <b>Switch Row/Column</b>.
In <b>Axis label range</b>, type the labels you want to add or click the <divclass ="icon icon-changerange"></div> icon on the right of the <b>Axis label range</b> box to select data range.
<li><b>Switch Row/Column</b> - rearrange the worksheet data that is configured in the chart not in the way that you want it. Switch rows to columns to display data on a different axis. </li>
</ul>
</li>
<li>Click <b>OK</b>button to apply the changes and close the window.</li>
Click the <b>Change Chart Type</b> button in the <b>Chart Editor</b> window to choose chart type and style. Select a chart from the available sections: Column, Line, Pie, Bar, Area, Stock, XY (Scatter), or Combo.
<p>When you choose <b>Combo Charts</b>, the <b>Chart Type</b> window lists chart series and allows choosing the types of charts to combine and selecting data series to place on a seconary axis.</p>
Change the chart settings by clicking the <b>Edit Chart</b> button situated in the <b>Chart Editor</b> window. The <b>Chart - Advanced Settings</b> window will open.
Specify the <b>Data Labels</b> position relative to the data points selecting the necessary option from the drop-down list. The available options vary depending on the selected chart type.
<li>For <b>Column/Bar</b> charts, you can choose the following options: <b>None</b>, <b>Center</b>, <b>Inner Bottom</b>, <b>Inner Top</b>, <b>Outer Top</b>.</li>
<li>For <b>Line/XY (Scatter)/Stock</b> charts, you can choose the following options: <b>None</b>, <b>Center</b>, <b>Left</b>, <b>Right</b>, <b>Top</b>, <b>Bottom</b>.</li>
<li>For <b>Pie</b> charts, you can choose the following options: <b>None</b>, <b>Center</b>, <b>Fit to Width</b>, <b>Inner Top</b>, <b>Outer Top</b>.</li>
<li>For <b>Area</b> charts as well as for <b>3D</b><b>Column</b>, <b>Line</b>, <b>Bar</b> and <b>Combo</b> charts, you can choose the following options: <b>None</b>, <b>Center</b>.</li>
<li>Select the data you wish to include into your labels checking the corresponding boxes: <b>Series Name</b>, <b>Category Name</b>, <b>Value</b>,</li>
<li>Enter a character (comma, semicolon etc.) you wish to use for separating several labels into the <b>Data Labels Separator</b> entry field.</li>
<li><b>Lines</b> - is used to choose a line style for <b>Line/XY (Scatter) charts</b>. You can choose one of the following options: <b>Straight</b> to use straight lines between data points, <b>Smooth</b> to use smooth curves between data points, or <b>None</b> to not display lines.</li>
<b>Markers</b> - is used to specify whether the markers should be displayed (if the box is checked) or not (if the box is unchecked) for <b>Line/XY (Scatter) charts</b>.
<pclass="note"><b>Note</b>: the <b>Lines</b> and <b>Markers</b> options are available for <b>Line charts</b> and <b>XY (Scatter) charts</b> only.</p>
<p>The <b>Vertical Axis</b> tab allows you to change the parameters of the vertical axis also referred to as the values axis or y-axis which displays numeric values. Note that the vertical axis will be the category axis which displays text labels for the <b>Bar charts</b>, therefore in this case the <b>Vertical Axis</b> tab options will correspond to the ones described in the next section. For the <b>XY (Scatter) charts</b>, both axes are value axes.</p>
<pclass="note"><b>Note</b>: the <b>Axis Settings</b> and <b>Gridlines</b> sections will be disabled for <b>Pie charts</b> since charts of this type have no axes and gridlines.</p>
<li><b>Minimum Value</b> - is used to specify the lowest value displayed at the vertical axis start. The <b>Auto</b> option is selected by default, in this case the minimum value is calculated automatically depending on the selected data range. You can select the <b>Fixed</b> option from the drop-down list and specify a different value in the entry field on the right.</li>
<li><b>Maximum Value</b> - is used to specify the highest value displayed at the vertical axis end. The <b>Auto</b> option is selected by default, in this case the maximum value is calculated automatically depending on the selected data range. You can select the <b>Fixed</b> option from the drop-down list and specify a different value in the entry field on the right.</li>
<li><b>Axis Crosses</b> - is used to specify a point on the vertical axis where the horizontal axis should cross it. The <b>Auto</b> option is selected by default, in this case the axes intersection point value is calculated automatically depending on the selected data range. You can select the <b>Value</b> option from the drop-down list and specify a different value in the entry field on the right, or set the axes intersection point at the <b>Minimum/Maximum Value</b> on the vertical axis.</li>
<li><b>Display Units</b> - is used to determine the representation of the numeric values along the vertical axis. This option can be useful if you're working with great numbers and wish the values on the axis to be displayed in a more compact and readable way (e.g. you can represent 50 000 as 50 by using the <b>Thousands</b> display units). Select desired units from the drop-down list: <b>Hundreds</b>, <b>Thousands</b>, <b>10 000</b>, <b>100 000</b>, <b>Millions</b>, <b>10 000 000</b>, <b>100 000 000</b>, <b>Billions</b>, <b>Trillions</b>, or choose the <b>None</b> option to return to the default units.</li>
<li><b>Values in reverse order</b> - is used to display values in the opposite direction. When the box is unchecked, the lowest value is at the bottom and the highest value is at the top of the axis. When the box is checked, the values are ordered from top to bottom.</li>
The <b>Tick Options</b> section allows adjusting the appearance of tick marks on the vertical scale. Major tick marks are the larger scale divisions which can have labels displaying numeric values. Minor tick marks are the scale subdivisions which are placed between the major tick marks and have no labels. Tick marks also define where gridlines can be displayed if the corresponding option is set on the <b>Layout</b> tab. The <b>Major/Minor Type</b> drop-down lists contain the following placement options:
<ul>
<li><b>None</b> to not display major/minor tick marks,</li>
<li><b>Cross</b> to display major/minor tick marks on both sides of the axis,</li>
<li><b>In</b> to display major/minor tick marks inside the axis,</li>
<li><b>Out</b> to display major/minor tick marks outside the axis.</li>
</ul>
</li>
<li>
The <b>Label Options</b> section allows adjusting the appearance of major tick mark labels which display values. To specify a <b>Label Position</b> in regard to the vertical axis, select the necessary option from the drop-down list:
<ul>
<li><b>None</b> to not display tick mark labels,</li>
<li><b>Low</b> to display tick mark labels to the left of the plot area,</li>
<li><b>High</b> to display tick mark labels to the right of the plot area,</li>
<li><b>Next to axis</b> to display tick mark labels next to the axis.</li>
<li>
To specify a <b>Label Format</b> click the Label Format button and choose a category as it deems appropriate.
<p>Available label format categories:</p>
<ul>
<li>General</li>
<li>Number</li>
<li>Scientific</li>
<li>Accounting</li>
<li>Currency</li>
<li>Date</li>
<li>Time</li>
<li>Percentage</li>
<li>Fraction</li>
<li>Text</li>
<li>Custom</li>
</ul>
<p>Label format options vary depending on the selected category. For more information on changing number format, go to <ahref="https://helpcenter.onlyoffice.com/ONLYOFFICE-Editors/ONLYOFFICE-Spreadsheet-Editor/UsageInstructions/ChangeNumberFormat.aspx">this page</a>.</p>
</li>
<li>Check <b>Linked to source</b> to keep number formatting from the data source in the chart.</li>
<pclass="note"><b>Note</b>: Secondary axes are supported in <b>Combo</b> chartsonly.</p>
<p><b>Secondary axes</b> are useful in Combo charts when data series vary considerably or mixed types of data are used to plot a chart. Secondary Axes make it easier to read and understand a combo chart.</p>
<p>The <b>Secondary Vertical /Horizontal Axis</b> tab appears when you choose an appropriate data series for a combo chart. All the settings and options on the <b>Secondary Vertical/Horizontal Axis</b> tab are the same as the settings on the Vertical/Horizontal Axis. For a detailed description of the <b>Vertical/Horizontal Axis</b> options, see description above/below.</p>
<p>The <b>Horizontal Axis</b> tab allows you to change the parameters of the horizontal axis also referred to as the categories axis or x-axis which displays text labels. Note that the horizontal axis will be the value axis which displays numeric values for the <b>Bar charts</b>, therefore in this case the <b>Horizontal Axis</b> tab options will correspond to the ones described in the previous section. For the <b>XY (Scatter) charts</b>, both axes are value axes.</p>
<li><b>Gridlines</b> is used to specify the <b>Horizontal Gridlines</b>to display by selecting the necessary option from the drop-down list: <b>None</b>, <b>Major</b>,<b>Minor</b>, or<b>Major and Minor</b>.</li>
<li><b>Axis Crosses</b> - is used to specify a point on the horizontal axis where the vertical axis should cross it. The <b>Auto</b> option is selected by default, in this case the axes intersection point value is calculated automatically depending on the selected data range. You can select the <b>Value</b> option from the drop-down list and specify a different value in the entry field on the right, or set the axes intersection point at the <b>Minimum/Maximum Value</b> (that corresponds to the first and last category) on the horizontal axis.</li>
<li><b>Axis Position</b> - is used to specify where the axis text labels should be placed: <b>On Tick Marks</b> or <b>Between Tick Marks</b>.</li>
<li><b>Values in reverse order</b> - is used to display categories in the opposite direction. When the box is unchecked, categories are displayed from left to right. When the box is checked, the categories are ordered from right to left.</li>
The <b>Tick Options</b> section allows adjusting the appearance of tick marks on the horizontal scale. Major tick marks are the larger divisions which can have labels displaying category values. Minor tick marks are the smaller divisions which are placed between the major tick marks and have no labels. Tick marks also define where gridlines can be displayed if the corresponding option is set on the <b>Layout</b> tab. You can adjust the following tick mark parameters:
<li><b>Major/Minor Type</b> - is used to specify the following placement options: <b>None</b> to not display major/minor tick marks, <b>Cross</b> to display major/minor tick marks on both sides of the axis, <b>In</b> to display major/minor tick marks inside the axis, <b>Out</b> to display major/minor tick marks outside the axis.</li>
<li><b>Interval between Marks</b> - is used to specify how many categories should be displayed between two adjacent tick marks.</li>
<li><b>Label Position</b> - is used to specify where the labels should be placed in regard to the horizontal axis. Select the necessary option from the drop-down list: <b>None</b> to not display category labels, <b>Low</b> to display category labels at the bottom of the plot area, <b>High</b> to display category labels at the top of the plot area, <b>Next to axis</b> to display category labels next to the axis.</li>
<li><b>Axis Label Distance</b> - is used to specify how closely the labels should be placed to the axis. You can specify the necessary value in the entry field. The more the value you set, the more the distance between the axis and labels is.</li>
<li><b>Interval between Labels</b> - is used to specify how often the labels should be displayed. The <b>Auto</b> option is selected by default, in this case labels are displayed for every category. You can select the <b>Manual</b> option from the drop-down list and specify the necessary value in the entry field on the right. For example, enter 2 to display labels for every other category etc.</li>
To specify a <b>Label Format</b> click the Label Format button and choose a category as it deems appropriate.
<p>Available label format categories:</p>
<ul>
<li>General</li>
<li>Number</li>
<li>Scientific</li>
<li>Accounting</li>
<li>Currency</li>
<li>Date</li>
<li>Time</li>
<li>Percentage</li>
<li>Fraction</li>
<li>Text</li>
<li>Custom</li>
</ul>
<p>Label format options vary depending on the selected category. For more information on changing number format, go to <ahref="https://helpcenter.onlyoffice.com/ONLYOFFICE-Editors/ONLYOFFICE-Spreadsheet-Editor/UsageInstructions/ChangeNumberFormat.aspx">this page</a>.</p>
</li>
<li>Check <b>Linked to source</b> to keep number formatting from the data source in the chart.</li>
<p>The <b>Cell Snapping</b> tab contains the following parameters:</p>
<ul>
<li><b>Move and size with cells</b> - this option allows you to snap the chart to the cell behind it. If the cell moves (e.g. if you insert or delete some rows/columns), the chart will be moved together with the cell. If you increase or decrease the width or height of the cell, the chart will change its size as well.</li>
<li><b>Move but don't size with cells</b> - this option allows to snap the chart to the cell behind it preventing the chart from being resized. If the cell moves, the chart will be moved together with the cell, but if you change the cell size, the chart dimensions remain unchanged.</li>
<li><b>Don't move or size with cells</b> - this option allows to prevent the chart from being moved or resized if the cell position or size was changed.</li>
<p>The <b>Alternative Text</b> tab allows specifying a <b>Title</b> and <b>Description</b> which will be read to people with vision or cognitive impairments to help them better understand what information the chart contains.</p>
<p><imgclass="floatleft"alt="Moving chart"src="../images/moving_chart.png"/>Once the chart is added, you can change its size and position. To change the chart size, drag small squares <spanclass ="icon icon-resize_square"></span> situated on its edges. To maintain the original proportions of the selected chart while resizing, hold down the <b>Shift</b> key and drag one of the corner icons.</p>
<p>To alter the chart position, use the <spanclass ="icon icon-arrow"></span> icon that appears after hovering your mouse cursor over the chart. Drag the chart to the necessary position without releasing the mouse button. When you move the chart, guide lines are displayed to help you position the object on the page precisely (if a wrapping style other than inline is selected).</p>
<b>Note</b>: the list of keyboard shortcuts that can be used when working with objects is available <ahref="../HelpfulHints/KeyboardShortcuts.htm#workwithobjects"onclick="onhyperlinkclick(this)">here</a>.
<p>To edit the chart <b>Title</b>, select the default text with the mouse and type the required text.</p>
<p>To change the font formatting within text elements, such as the chart title, axes titles, legend entries, data labels etc., select the necessary text element by left-clicking it. Then use the corresponding icons on the <b>Home</b> tab of the top toolbar to change the font <ahref="../UsageInstructions/FontTypeSizeColor.htm"onclick="onhyperlinkclick(this)">type, size, color</a> or its <ahref="../UsageInstructions/DecorationStyles.htm"onclick="onhyperlinkclick(this)">decoration style</a>.</p>
<p>When the chart is selected, the <b>Shape settings</b><spanclass ="icon icon-shape_settings_icon"></span> icon is also available on the right, since a shape is used as a background for the chart. You can click this icon to open the <b>Shape settings</b> tab on the right sidebar and adjust <ahref="../UsageInstructions/InsertAutoshapes.htm#shape_fill"onclick="onhyperlinkclick(this)"><b>Fill</b></a>, <ahref="../UsageInstructions/InsertAutoshapes.htm#shape_stroke"onclick="onhyperlinkclick(this)"><b>Stroke</b></a> and <b>Wrapping Style</b> of the shape. Note that you cannot change the shape type.</p>
Using the <b>Shape Settings</b> tab on the right panel, you can both adjust the chart area itself and change the chart elements, such as <em>plot area</em>, <em>data series</em>, <em>chart title</em>, <em>legend</em> etc and apply different fill types to them. Select the chart element clicking it with the left mouse button and choose the preferred fill type: <em>solid color</em>, <em>gradient</em>, <em>texture</em> or <em>picture</em>, <em>pattern</em>. Specify the fill parameters and set the <em>Opacity</em> level if necessary.
When you select a vertical or horizontal axis or gridlines, the stroke settings are only available at the <b>Shape Settings</b> tab: <em>color</em>, <em>width</em> and <em>type</em>. For more details on how to work with shape colors, fills and stroke, you can refer to <ahref="../UsageInstructions/InsertAutoshapes.htm"onclick="onhyperlinkclick(this)">this page</a>.
</p>
<pclass="note"><b>Note</b>: the <b>Show shadow</b> option is also available at the <b>Shape settings</b> tab, but it is disabled for chart elements.</p>
<p>If you need to resize chart elements, left-click to select the needed element and drag one of 8 white squares <spanclass ="icon icon-resize_square"></span> located along the perimeter of the element.</p>
<p>To change the position of the element, left-click on it, make sure your cursor changed to <spanclass ="icon icon-arrow"></span>, hold the left mouse button and drag the element to the needed position.</p>
<p>You can also rotate 3D charts using the mouse. Left-click within the plot area and hold the mouse button. Drag the cursor without releasing the mouse button to change the 3D chart orientation.</p>
<p>Some of the chart settings can be altered using the <b>Chart settings</b> tab of the right sidebar. To activate it click the chart and choose the <b>Chart settings</b><spanclass ="icon icon-chart_settings_icon"></span> icon on the right. Here you can change the following properties:</p>
<li><b>Wrapping Style</b> is used to select a text wrapping style from the available ones - inline, square, tight, through, top and bottom, in front, behind (for more information see the advanced settings description below).</li>
<li><b>Cut, Copy, Paste</b> - standard options which are used to cut or copy the selected text/object and paste the previously cut/copied text passage or object to the current cursor position.</li>
<li><b>Arrange</b> is used to bring the selected chart to foreground, send it to the background, move forward or backward as well as group or ungroup charts to perform operations with several of them at once. To learn more on how to arrange objects, please refer to <ahref="../UsageInstructions/AlignArrangeObjects.htm"onclick="onhyperlinkclick(this)">this page</a>.</li>
<li><b>Align</b> is used to align the chart left, center, right, top, middle, bottom. To learn more on how to align objects you can refer to <ahref="../UsageInstructions/AlignArrangeObjects.htm"onclick="onhyperlinkclick(this)">this page</a>.</li>
<li><b>Wrapping Style</b> is used to select a text wrapping style from the available ones - inline, square, tight, through, top and bottom, in front, behind. The <b>Edit Wrap Boundary</b> option is unavailable for charts.</li>
<li><b>Edit Data</b> is used to open the 'Chart Editor' window.</li>
<p>To change the chart advanced settings, click the needed chart with the right mouse button and select <b>Chart Advanced Settings</b> from the right-click menu or just click the <b>Show advanced settings</b> link on the right sidebar. The chart properties window will open:</p>
<li><b>Width</b> and <b>Height</b> - use these options to change the width and/or height of the chart. If the <b>Constant Proportions</b><divclass ="icon icon-constantproportions"></div> button is clicked (in this case it looks like this <divclass ="icon icon-constantproportionsactivated"></div>), the width and height will be changed together preserving the original chart aspect ratio.</li>
<p><imgalt="Chart - Advanced Settings: Text Wrapping"src="../images/chart_properties_1.png"/></p>
<p>The <b>Text Wrapping</b> tab contains the following parameters:</p>
<ul>
<li><b>Wrapping Style</b> - use this option to change the way the chart is positioned relative to the text: it will either be a part of the text (in case you select the inline style) or bypassed by it from all sides (if you select one of the other styles).
<li><p><divclass ="icon icon-wrappingstyle_inline"></div><b>Inline</b> - the chart is considered to be a part of the text, like a character, so when the text moves, the chart moves as well. In this case the positioning options are inaccessible.</p>
<li><p><divclass ="icon icon-wrappingstyle_square"></div><b>Square</b> - the text wraps the rectangular box that bounds the chart.</p></li>
<li><p><divclass ="icon icon-wrappingstyle_tight"></div><b>Tight</b> - the text wraps the actual chart edges.</p></li>
<li><p><divclass ="icon icon-wrappingstyle_through"></div><b>Through</b> - the text wraps around the chart edges and fills in the open white space within the chart.</p></li>
<li><p><divclass ="icon icon-wrappingstyle_topandbottom"></div><b>Top and bottom</b> - the text is only above and below the chart.</p></li>
<li><p><divclass ="icon icon-wrappingstyle_infront"></div><b>In front</b> - the chart overlaps the text.</p></li>
<li><p><divclass ="icon icon-wrappingstyle_behind"></div><b>Behind</b> - the text overlaps the chart.</p></li>
<p>If you select the square, tight, through, or top and bottom styles, you will be able to set up some additional parameters - <b>distance from text</b> at all sides (top, bottom, left, right).</p>
<p>The <b>Position</b> tab is available only if the selected wrapping style is not inline. This tab contains the following parameters that vary depending on the selected wrapping style:</p>
<li>Absolute <b>Position</b> measured in absolute units i.e. <b>Centimeters</b>/<b>Points</b>/<b>Inches</b> (depending on the option specified on the <b>File</b> -> <b>Advanced Settings...</b> tab) <b>to the right of</b> character, column, left margin, margin, page or right margin,</li>
<li>Absolute <b>Position</b> measured in absolute units i.e. <b>Centimeters</b>/<b>Points</b>/<b>Inches</b> (depending on the option specified on the <b>File</b> -> <b>Advanced Settings...</b> tab) <b>below</b> line, margin, bottom margin, paragraph, page or top margin,</li>
<p>The <b>Alternative Text</b> tab allows specifying a <b>Title</b> and <b>Description</b> which will be read to the people with vision or cognitive impairments to help them better understand what information the chart contains.</p>
