IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Create a workpad Present your workpad »
Elastic Docs ›Kibana Guide [7.7] ›Canvas ›Create a workpad

Add elements

edit

Add elements

edit

Create a story about your data by adding elements to your workpad that include images, text, charts, and more. You can create your own elements and connect them to your data sources, add saved objects, and add your own images.

Create an element

edit

Choose the type of element you want to use, then connect it to your own data.

  1. Click Add element, then select the element you want to use.

    Canvas elements

  2. To familiarize yourself with the element, use the preconfigured data demo data.

    By default, most of the elements you create use demo data until you change the data source. The demo data includes a small data set that you can use to experiment with your element.

  3. To connect the element to your data, select Data, then select one of the following data sources:

    • Elasticsearch SQL — Access your data in Elasticsearch using SQL syntax. For information about SQL syntax, refer to SQL language.
    • Elasticsearch documents — Access your data in Elasticsearch without using aggregations. To use, select an index and fields, and optionally enter a query using the Lucene Query Syntax. Use the Elasticsearch documents data source when you have low volume datasets, to view raw documents, or to plot exact, non-aggregated values on a chart.
    • Timelion — Access your time series data using Timelion queries. To use Timelion queries, you can enter a query using the Lucene Query Syntax.

Add a saved object

edit

Add a saved object, then customize it to fit your display needs.

  1. Click Embed object.

  2. Select the object you want to add.

    canvas map embed

  3. To use the customization options, click the panel menu, then select one of the following options:

    • Edit map — Opens Maps so that you can edit the original map.
    • Customize panel — Specifies the object title options.
    • Inspect — Allows you to drill down into the element data.
    • Customize time range — Exposes a time filter dedicated to the map.

Add your own image

edit

To personalize your workpad, add your own logos and graphics.

  1. Click Manage assets.
  2. On the Manage workpad assets window, drag and drop your images.

  3. To add the image to the workpad, click the Create image element icon.

    canvas add image

Organize elements

edit

Move and resize your elements to meet your design needs.

  • To move, click and hold the element, then drag to the new location.
  • To move by 1 pixel, select the element, press and hold Shift, then use your arrow keys.
  • To move by 10 pixels, select the element, then use your arrow keys.
  • To resize, click and drag the resize handles to the new dimensions.

Format elements

edit

Align, distribute, and reorder elements for consistency and readability across your workpad pages.

Access the align, distribute, and reorder options by clicking the Element options icon.

canvas element options

To align elements:

  1. Press and hold Shift, then select the elements you want to align.
  2. Click the , then select Group.
  3. Click the Element options icon, then select Alignment.
  4. Select the alignment option.

To distribute elements:

  1. Press and hold Shift, then select the elements you want to distribute.
  2. Click the Element options icon, then select Group.
  3. Click the Element options icon, then select Distribution.
  4. Select the distribution option.

To reorder elements:

  1. Select the element you want to reorder.
  2. Click the Element options icon, then select Order.
  3. Select the order option.

Change the element display options

edit

Each element has its own display options to fit your design needs.

To choose the display options, click Display, then make your changes.

To define the appearance of the container and border:

  1. Next to Element style, click +, then select Container style.
  2. Expand Container style.
  3. Change the Appearance and Border options.

To apply CSS overrides:

  1. Next to Element style, click +, then select CSS.

  2. Enter the CSS.

    For example, to center the Markdown element, enter:

    .canvasRenderEl h1 {
text.align: center;
}
  3. Click Apply stylesheet.

Save elements

edit

To use the elements across all workpads, save the elements.

When you’re ready to save your element, select the element, then click the Save as new element icon.

canvas save element

To save a group of elements, press and hold Shift, then select the elements you want to save.

To access your saved elements, click Add element, then select My elements.

Delete elements

edit

When you no longer need an element, delete it from your workpad.

  1. Select the element you want to delete.

  2. Click the Element options icon.

    canvas element options
  3. Select Delete.
« Create a workpad Present your workpad »