Slices
Last updated
Was this helpful?
Last updated
Was this helpful?
Slices are the basic building blocks of your story. Slices are added to . Each slice can have text either by itself or with media (image or video) or a .
To add a slice to an empty section, click on the section header and select the slice type from the list. To add a slice to a section that has one or more slices, click the + button where you want the new slice to appear and select the slice type from the dropdown.
Rather than adding a brand new slice, it may be easier to duplicate and modify an existing slice. To duplicate a slice, select the gear icon and then select Duplicate. The duplicated slice will appear directly below the original slice.
To delete a slice, select the gear icon and then select Delete.
Every slice can have text and either a chart or media (i.e., image or video). To add text to a slice, type in the draft report where you want the text to appear and use the text editor to style the text.
Until you configure your chart, the chart will display an error message.
To add an image or video to a slice, select the Add Media button and upload your own image, find an image on Unsplash, or a paste a URL to a YouTube or Vimeo video.
If you want to delete the chart or media content in a slice and go back to a Text slice, click the trash can icon.
Each slice type has a specific set of configuration options, but the following options are shared by multiple slice types:
Data Table. A dropdown will display if there is more than one data source connected to the report. The slice will use the selected data source.
Hide if no data. If turned on, the entire slice will be hidden if all data has been filtered out. If turned off, the slice will display with a message notifying the viewer that all data has been filtered out.
Selections. You can select whether user selections are allowed and, if so, how many. You can also specify how selected items will be used. The options are:
as Filters. This is the default. Selections will filter downstream slices.
as Variables. Selections will not filter downstream slices. Instead, the selected values will be saved as variables that can be used in defining ingredients.
as Filters and Variables. Selections will both filter downstream slices and be saved as variables that can be used in defining ingredients.
Variables are very powerful. Learn more here.
Display. You can select which elements of a slice should display.
Chart/Media position. If a slice has a chart (or media), there are four layout options that control how the chart (or media) will appear in relation to the slice text.
The slice text will display above the chart/media. This is the default layout.
The chart/media will display above the slice text.
The slice text will display on the left, and the chart/media will display on the right.
The chart/media will display on the left, and the slice text will display on the right.
Show legend. Some charts have legends. Turn this off to hide the legend.
Show notes. Some charts have notes. Turn this off to hide the notes.
Filters applied footnote. If turned on, a footnote will display in each slice showing which filters are being applied to the slice.
Each slice has a unique id that is called a "slug". Slices with text only or media will have a slug like Text1 or Text5. Slices with charts will have a slug like Table1 or Scatterplot2. You can see the slice slug in the draft app as a badge in the top-left corner of the slice on hover. Clicking the badge in the draft app will scroll the slice into view in the editing panel.
Slices with charts also show their slug in the editing panel as a badge. The slug for charts is often used in dynamic text [and other places]. To copy the slug, click the @ button next to the badge.
By default, slices have a transparent background (revealing the section background color). To adjust the slice background color, click the paint drop icon, and select the desired theme color. If you have a specific color in mind, you can enter the hex code for that color after clicking the Custom button. You can also click the Customize button to modify the color theme.
To reorder slices, drag and drop the slice where you want it to display. You can reorder slices within a section and move slices to different sections.
To add a chart to a Text slice, select the Add Chart button and select the desired from the list.
Below text
Above text
Right of text
Left of text
