Skip to main content Skip to complementary content

Histogram properties

You open the properties panel for a visualization by clicking Edit Edit sheet in the toolbar and clicking the visualization that you want to edit.

If the properties panel is hidden, click open right panel Show properties in the lower right-hand corner.

Information noteIf the visualization displays Linked Object Linked visualization in the properties panel, the visualization is linked to a master item. You can edit the master item or unlink the visualization from the master item to edit only the current visualization.
Information noteSome of the settings in the properties panel are only available under certain circumstances, for example, when you use more than one dimension or measure, or when you select an option that makes other options available.


Click Add to add a field.


On the Data tab, under Fields, click Add to open a list of available Fields. Select the field that you want to use.

You can also click Expression to create a field in the expression editor. Another way to create a field is to type the expression directly in the text box. Expressions added in this way must begin with an equals sign (=). Here is an example with a calculated field:

=If (Week < 14, Week, 'Sales')

If Add is dimmed, you cannot add more fields.

  • <Field name>

    Field: Click the field name to open the field settings.

    If you want to delete the field, right-click the field and select Delete in the dialog. Alternatively, click the field and click Delete.

    • Field: If you have added a field from Fields in the assets panel, the field name is automatically displayed. Click Expression to open the expression editor.

    • Label: Enter a label for the field.
    • Include null values: When selected, the measure values of all null dimensions are summarized and presented as one dimension item in a visualization. All null values are displayed as gaps or dashes (-).
    • Master item: Create a master dimension based on the dimension expression by clicking Add new. If the dimension is already linked to a master item, click Edit to update the master item. All instances of the linked dimension will be updated.

  • Add alternative: Alternative fields are fields that are added to a visualization, but are not displayed until a user chooses to switch which fields are being displayed during visual exploration.

Histogram settings

  • Bars: You can set Bars to Auto or Custom:

    Auto divides the data into the optimal number of bars based on the current data selection. You do not need to make any other settings. The calculation is based on Sturge's formula.

    Custom lets you define how to divide the data into bars.

  • Number of bars: Set Maximum number to the number of bars you want to divide the data into.
  • Bar width (x-axis): Set Width to define how wide each bar is. This is based on the values on the x-axis.

    You can offset the bars by changing the Offset setting.


    If you set Width to 2 and keep the default Offset setting 0, your bars may be defined 0 to 2, 2 to 4, 4 to 6, and so on. If you change Offset to 1, the bars are defined -1 to 1, 1 to 3, 3 to 5, and so on.

  • Count distinct values only: Select this to exclude duplicate values.


  • Data handling: Include zero values: When unselected, measures that have the value ‘0’ are not included in the presentation. If there is more than one measure value, all the measure values must have the value ‘0’ to be excluded from the presentation.

    • Calculation condition: Specify an expression in this text field to set a condition that needs to be fulfilled (true) for the object to be displayed. The value may be entered as a calculated formula. For example: count(distinct Team)<3. If the condition is not fulfilled, the message or expression entered in Displayed message is displayed.

    A calculation condition is useful when a chart or table is slow to respond due to a large amount of data. You can use the calculation condition to hide an object until the user has filtered the data to a more manageable level by applying selections. Use the Displayed message property to guide the user to filter the data.

  • Reference lines: Add reference line: Click to add a new reference line.

    • Show: When selected, the reference line is displayed.
    • Label: Enter a label for the reference line.
    • Color: In the color picker, select the color of the reference line and the label.
    • Reference line expression: Enter a value or an expression for the reference line. Click Expression to open the expression editor.
  • Delete: Click to remove the reference line.



  • Show titlesOn by default in all visualizations except filter panes, KPIs, and text & image visualizations.

    Enter Title, Subtitle, and Footnote. By default, the string is interpreted as a text string. However, you can also use the text field for an expression, or a combination of text and expression. An equals sign (=), at the beginning of a string shows that it contains an expression.

    Click Expression if you want to create an expression by using the expression editor.

    Information noteTitles are displayed on a single line. If you inject line breaks they will be ignored.


    Assume that the following string is used, including quotation marks: 'Sales: ' & Sum(Sales).

    By default, the string is interpreted as a text string and is displayed as presented in the example. But if you begin the string with an equals sign: (='Sales: ' & Sum(Sales)), the string is interpreted as an expression instead. The output is then Sales: <value of expression>, where <value of expression> is the calculated value.

  • Disable hover menu: Select to disable the hover menu in the visualization.

  • Show details: Set to Show if you want to allow users to be able to choose to view details, such as descriptions, measures, and dimensions.

Alternate states

  • State: Set the state to apply to the visualization. You can select:

    • Any alternate state defined in Master items.
    • <inherited>, in which case the state defined for the sheet is used.
    • <default state>, which represents the state where no alternate state is applied.

    For more information about alternate states, see Using alternate states for comparative analysis.


Gridline spacing: Set this to Custom if you want to customize the horizontal gridlines. You can choose between: No lines, Medium, or Narrow.

Value labels: By default, Off. With the Auto setting, the value labels are displayed when there is enough space.

  • Colors: You can only set the bar color of the histogram.
  • Y-axis: Frequency When set to Auto, the label is displayed if there is enough space.
    • Labels and title: Select what to display of labels and title.
    • Position: Select where to display the frequency axis.

    • Scale: Set the spacing of the frequency axis scale.

    • Range: Select to set the min value, the max value, or both. The min value cannot be larger than the max value. You can use expressions for the values.

    • Label: Set the label for the frequency axis.

  • X-axis: <Field>:
    • Labels and title: Select what to display of labels and title.
    • Position: Select where to display the field axis.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!