Skip to main content Skip to complementary content

Straight table

The Straight table shows several fields simultaneously, where the content of each row is logically connected. A table can consist of as many dimensions and measures as needed. The Straight table is included in the Visualization bundle, available in Advanced options.

App creators can add many fields simultaneously, customize the table at the column-level, add alternative dimensions and measures, set column width, apply pagination and turn on chart exploration.

Chart exploration allows users that do not have edit rights to customize the original straight table when they are in analysis mode. These users can add or remove columns, change sort order, re-arrange columns, and make selections. They can then share, download, subscribe, or bookmark the new table layout. The changes made in chart exploration mode by a user are not seen by other users analyzing the sheet.

Information noteThis page is about the Visualization bundle straight table. For information on the native table object, see Table.

When to use it

Use a straight table when you want to view detailed data and precise values rather than visualizations of values. Tables are good when you want to compare individual values. Drill-down group dimensions are very efficient in tables. Within a limited space, you can drill down to the next level of detail and analyze the updated measure values. Use this table when you want users to be able to create custom tables in analysis mode.

Advantages

You can filter and sort the table in different ways. Many values can be included in a table, and when you drill down in a table, you make good use of the limited space on the sheet. A table is excellent when you want to see exact values rather than trends or patterns. Tables are an easy way to export data into other programs.

Disadvantages

If the straight table contains many values, it is difficult to get an overview of how values are related. It is also hard to identify an irregularity within the table.

Best practices for optimizing tables

If a table has too many dimensions and measures, it may load slowly. As a best practice, add the majority of your fields and expressions as Alternative columns. This encourages users to add only the fields they need using chart exploration.

You can also increase performance by ensuring a table has 10 columns or less.

Tables that extract fields from a single data source will perform better than tables that contain fields from multiple data sources.

Creating a straight table

You can create a straight table on the sheet you are editing.

  1. In the advanced edit mode assets panel, open Custom objects > Qlik Visualization bundle and drag a Straight table object to the sheet.
  2. Click Add columns to add items to the table. A dropdown will open:
    • Fields & master items: Opens a searchable dialog box displaying every field and master item. You can choose to add any item as a dimension or measure.
    • Custom expression: Opens a dialog box where you can type in an expression, or open the expression editor .
  3. In the properties panel, under Data, click to add more dimensions or measures to the table.

When you have created the table, you may want to adjust its appearance and other settings in the properties panel. For information about styling, see Styling the straight table.

Tip noteBy default, column widths are all set to one value, so that the sum of them equals the width of the chart. You can adjust the width of a column by dragging the header divider. Double-click the header divider to reset to the default width.

Working with table items

  1. In the Data tab of the properties panel, under Columns and Alternative columns, click the checkbox next to any item. Click to perform actions such as cut, paste, and delete. Click the checkbox next to Columns or Alternative columns to select all items in the list. Use the arrow icons to move items between each section.

    Information noteAlternative columns are columns that users can choose to add to the table when using Using chart exploration.
  2. To change the column order, clicknext to a field or expression and drag the item.

  3. Click on an item name to open its individual properties. Here you can change the label, set a background color for the column, control text alignment, set column width, and more. For more information, see the sections below.

    Information noteIf Text alignment is set to Auto, column data is aligned according to data type: text values are left-aligned and number values, including date related values, are right-aligned. If you set it to Custom, you can align the data to the left, center, or right.

Data tab in the properties panel when a straight table is selected. The Customer field was clicked, so related dimension properties are displayed on the left.

The properties panel when a straight table is selected. Showing the data pane.

Defining column text style with an expression

For each column, you can set a separate expression to define how the column text is styled. If you style a column's text with an expression, this expression overrides the app theme, and any custom styling applied to the visualization, for that column.

You can use the following syntax in your expression to define the styling (the letter in the tag is not case sensitive):

  • <B>: Bold

  • <I>: Italics

  • <U>: Underlined

  • <S>: Strikethrough

More than one of the options above can be applied at a time.

Examples:

if(avg(Sales) > 300, '<B>')
if(count(OrderID) = 0, '<S>')
if(sum(Sales) > 100000, '<B><U>', '<I>')
  1. Under Data, select a column and open Presentation in the properties.

  2. Under Text style expression, enter the expression. Click to open the expression editor.

Formatting dimension representation

You can format dimension columns to show values, links, or images using Representation in the properties panel. You can select the following representations: 

  • Text: Displays the dimension values as text. This is the default value.
  • Link: Displays values as clickable links. Either the dimension value is used or the URL or you can add other URLs to the displayed dimension values.

Formatting links

Information note

The character ; is not supported as a query parameter separator in a URL.

  1. Under Data, select a dimension and open Presentation in the properties.

  2. Under Representation, select Link.

  3. Under Link setting, select one of the following:

    • Add label: The dimension contains the destination URL in either the dimension expression or the data table. The links are displayed and ordered by destination URL expression.

      Under Link label, enter a descriptive text label for the destination URL. Click to open the expression editor.

    • Add URL: The dimension values become selectable text links that are labels for the URLs.

      Under Link URL, enter the destination URL expression. Click to open the expression editor.

Formatting images

Warning note

Images in straight tables are only accessible from servers and domains that have been safe-listed. Administrators make these resources available in Administration by adding Content-Security-Policies (CSP) for each server or domain. CSP helps to prevent cross-site scripting attacks by controlling what resources a browser can request from a server.

Information note

The character ; is not supported as a query parameter separator in a URL.

  1. Under Data, select a dimension and open Presentation in the properties.

  2. Under Representation, select Image.

  3. Under Image setting, select one of the following:

    • Add label: The dimension contains the absolute URL to the image in either the dimension expression or the data table. The links are displayed and ordered by the URL expression.

      Under Image label, enter a descriptive text label for the image that displays as alternative text when the image is hovered over. Click to open the expression editor.

    • Add URL: The dimension values become labels for the alternative text that displays when the image is hovered over.

      Under Image URL, enter the destination URL expression. Click to open the expression editor.

  4. Under Sizing, select one of the following sizing options:

    • Always fit

    • Fit to width

    • Fit to height

    • Stretch to fit

    • Original size

  5. Under Position, select the image position within the cell.

Sorting the table

You can adjust the sorting of the table in several ways:

  • Column sorting: Adjust the order of the dimensions and measures from left to right .
  • Row sorting: Adjust the sorting priority order of the rows.
  • Internal sorting: Use the internal sorting order of dimensions and measures.
  • Interactive sorting: During analysis, you can click on a column header to sort the table.

Column sorting

By default, the order in which columns are sorted is set by the order in which dimensions and measures are added to the table. If you add the measure Sales first, it is presented first (leftmost) in the table. The next dimension or measure that is added is presented in the second column, and so on. The column sorting order can be changed in the advanced properties panel, under Columns.

Row sorting

By default, rows are sorted by the first added dimension or measure, numeric values descending, text values ascending. A small arrow under the column header shows by which column the table is sorted.

You can change the row sorting in the properties panel, under Sorting. Drag the dimensions and measures to change the sorting priority order. In many cases, sorting is not only affected by the first dimension or measure in Sorting, but also the following ones.

Example:  

In the following screenshot, the rows are first sorted by Customer, then by Month, and then by Product Type. As you can see, the columns Customer and Month have several rows with the same values (A-2-Z Solutions and Month). The rows in Product Type are ordered alphabetically, but only those that were sold in January to the customer A-2-Z Solutions are displayed.

Table with sorting order: Customer, Month, Product type.

By changing the sorting order, so that secondary sorting is by Product Type, followed by Month, all Product Type items sold to the customer A-2-Z Solutions are presented in alphabetical order, whereas only the months when they were sold are displayed under Month.

Table with sorting order: Customer, Product type, Month.

Internal sorting

Each dimension and measure has a default (Auto) internal sorting order, which can be changed. Under Sorting, click the item you want to change and click the button to switch to Custom sorting. Changes made to the internal sorting of an item may not have any effect if the sorting is in conflict with an item with higher priority.

Interactive sorting

During analysis, you can set which column to sort on by clicking the column header. The first click sorts the table according to the default sorting of the selected item. A second click reverses the sorting order. Interactive sorting is session based and is not saved. If you want your changes to the sorting to be persistent, you need to make the changes in the properties panel.

Users with Can edit rights can sort interactively using chart exploration, click Edit sheet, and save those changes to the original table

Working with add-ons

Straight tables have the following options under Add-ons in the properties panel:

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.

    Using Calculation Conditions

Changing the appearance of the straight table

Under Appearance in the properties panel, you can change the appearance of the straight table.

Turning on the hover menu

Under AppearanceGeneral, use the toggle for Show hover menu to choose whether want the hover menu to display in the visualization.

Showing details

Under AppearanceGeneral, set Show details to Show if you want to allow users to be able to choose to view details, such as descriptions, measures, and dimensions.

Allowing users to view expressions in the chart

Under AppearanceGeneral, set Show expressions to Show if you want to allow users to be able to choose to view expressions.

Showing totals

Under Appearance > Presentation, you can configure whether a row is displayed in the chart to show totals. Use the Totals toggle to select between the following options:

  • Auto: The totals (the result of the expression), are automatically included at the top of the table.
  • Custom: Select whether to display the totals and where to display them, at the top or bottom.

If you have selected to show totals, you can configure the label for the totals row by entering a value or expression for Totals label.

Using pagination

Under Appearance > Presentation, turn on the Use pagination setting to change how many rows are displayed in the chart. With pagination, instead of displaying all rows at once, only a certain amount of rows are displayed. Users can use the arrow buttons at the bottom of the table to navigate.

Using text wrapping

When text in the straight table is too long to be displayed given the provided space, some text is not shown and instead represented with an ellipsis. Under AppearancePresentation, you can use the settings under Multiline text wrapping to wrap the text over multiple lines in the table. This setting can be controlled individually at the header and cell levels:

  • Wrap text in headers (table headers only)

  • Wrap text in cells (table cells only)

Styling the straight table

With Advanced options turned on, you have a number of styling options available under Appearance in the properties panel.

Click Styling under Appearance > Presentation to further customize the styling of the chart. The styling panel contains various sections under the General and Chart tabs.

You can reset your styles by clicking next to each section. Clicking Reset all resets styles for all available tabs in the styling panel.

For general information about styling an individual visualization, see Applying custom styling to a visualization.

Customizing the text

You can set the text for the title, subtitle, and footnote under Appearance > General. To hide these elements, turn off Show titles.

The visibility of the different labels on the chart depends on chart-specific settings and label display options. These can be configured in the properties panel.

You can style the text that appears in the chart.

  1. In the properties panel, expand the Appearance section.

  2. Under AppearancePresentation, click Styling.

  3. On the General tab, set the font, emphasis style, font size, and color for the following text elements:

    • Title

    • Subtitle

    • Footnote

  4. On the Chart tab, set the font, emphasis style, font size, and color for the following text elements:

    • Header: Style the text of the headers for the dimensions and measures.

    • Dimension values: Style the text dimension values.

    • Measure values: Style the text of the measure values.

    • Totals: Style the text of the totals, if you have selected to show a Totals row under Appearance > Presentation.

    • Null values: Style the text of the null values.

  5. On the Chart tab, customize the Null values styling. You can change emphasis style and color.

You can also style the text for each column in the table. You can configure text color, style, and alignment. These settings are configured in the Data tab of the properties panel. If you have styled a column individually, this styling will override any text styling applied at the chart level. For more information, see Working with table items.

Additionally, you can customize how the text appears when a user hovers over a row. See Customizing the hover behavior.

Customizing the background

You can customize the background of the chart. The background can be set by color and image.

  1. Click Advanced options.

  2. In the properties panel, expand the Appearance section.

  3. Under AppearancePresentation, click Styling.

  4. On the General tab of the styling panel, you can select a background color (single color or expression). You can also set the background to an image from your media library or from a URL.

    Information note

    To add a background image from a URL, the URL's origin needs to be added to the allowlist in your tenant's Content Security Policy. The origin must be added with the following Directive: img-src. This is done by a tenant administrator.

    For more information, see Creating a CSP entry.

    When using a background color, use the slider to adjust the opacity of the background. The chart header always displays with 100% opacity.

    When using a background image, you can adjust image sizing and position.

  5. On the Chart tab, customize the background color for the following elements:

    • Header (100% opacity is used)
    • Dimension values

    • Measure values

    • Measure labels

    • Totals (100% opacity is used)

    • Null values

Customizing the grid

You can customize the table grid.

  1. In the properties panel, expand the Appearance section.

  2. Under AppearancePresentation, click Styling.

  3. On the Chart tab, customize the grid with the following elements:

    • Row height: Set the height of rows in lines.

    • Border: Set the color of the cell borders.

    • Divider: Set the color of the divider between that divides the header and body of the table.

Customizing the hover behavior

You can set display options for when a user hovers over a row in the table.

  1. Click Advanced options.

  2. In the properties panel, expand the Appearance section.

  3. Under AppearancePresentation, click Styling.

  4. On the Chart tab of the styling panel, under Row hover, adjust the following settings:

    • To highlight rows in the table when a user hovers over them, set the switch to On. Switch the behavior off according to preference.

    • Row hover color: Set the color to highlight the row when a user hovers over it.

    • Row hover font color: Set the color of the text in the highlighted row when a user hovers over it.

Customizing the border and shadow

You can customize the border and shadow of the chart.

  1. Click Advanced options.

  2. In the properties panel, expand the Appearance section.

  3. Under AppearancePresentation, click Styling.

  4. On the General tab of the styling panel, under Border, adjust the Outline size to increase or decrease the border lines around the chart.

  5. Select a color for the border.

  6. Adjust the Corner radius to control the roundness of the border.

  7. Under Shadow in the General tab, select a shadow size and color. Select None to remove the shadow.

Using chart exploration

Chart exploration allows app consumers and other users that do not have edit rights to customize the original straight table when they are in analysis mode. It is available in the menu under Chart exploration.

App consumers and viewers can use chart exploration to add or remove columns from a table, re-sort columns, change column width, and apply selections. You cannot change the size or layout of the entire table on the sheet in chart exploration mode.

Chart exploration mode is a great way to quickly remove or add data, and then share it, download it, or bookmark the new table state. It is very helpful in apps that have many viewers with different needs. The chart exploration panel is not shown in the resulting table that you have shared or downloaded.

If you customize a table using chart exploration mode, other users cannot see your changes, unless you save them as a public bookmark. This means that several users can alter the same table, at the same time. Your changes will remain visible to you if you refresh your browser page, but will be lost if you log out or your session times out. If this occurs, the table will return to its default state, as set by the person who created the straight table. If you want to save your table layout, create a bookmark. For more information, see Creating bookmarks.

Users with Can edit rights can make changes to the table using chart exploration, click Edit sheet, and save those changes to the original table.

App developers can turn on Chart exploration in the properties panel:

  • Enable chart exploration: Toggle this on to allow chart exploration.

  • Visibility option:

    • Auto: Chart exploration panel is visible when users open the sheet.

    • Minimized: Chart exploration is turned on, but not visible when users open the sheet. Users can open it in the hover menu by clicking and then Chart exploration.

For a table item to be available in chart exploration mode, the table creator (or a user with Can edit rights) must have added those fields, master items, or expressions to the table as columns or alternative columns. For more information, see Working with table items.

Chart exploration of a straight table. The table has three columns: Customer, Region, City.

Straight table in view mode, with chart exploration turned on.

Chart exploration of the same table as above, but with two measures added to the table: Sales and Cost. The background colors are the result of an expression.

Straight table in view mode, with chart exploration turned on.

Limitations

Chart exploration not available if table is embedded in certain charts

Chart exploration is not available if the table is embedded inside any of the following objects:

  • An existing container object that has not been replaced with a tab container. The tab container became the native container object on November 5, 2024.

    Chart exploration is also not available in existing instances of the deprecated ShowHide container and Tabbed container objects. However, converting these objects to tab containers is not recommended. Instead, create a new tab container from scratch in order to access chart exploration in straight tables.

    Container

  • Trellis container

    Trellis container

Number of rows displayed

If pagination is turned on, you can only display 100 rows at a time. If pagination is turned off, you can display up to 250 000 rows at a time. If your table has more than 250 000 rows, pagination will be applied.

Because huge tables are impractical and hard to manage, the limit for what is practical is far less than the theoretical maximum. In most cases, it is desirable to see all the columns without scrolling horizontally.

Accessibility

The straight table is only fully accessible if pagination if turned on. For more information on keyboard navigation, see Keyboard navigation and shortcuts in apps.

Learn more

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!