[role="xpack"]
[[canvas]]
= Canvas

[partintro]
--

*Canvas* is a data visualization and presentation tool that allows you to pull live data from {es}, 
then combine the data with colors, images, text, and your imagination to create dynamic, multi-page, pixel-perfect displays. 
If you are a little bit creative, a little bit technical, and a whole lot curious, then *Canvas* is for you.

With *Canvas*, you can:

* Create and personalize your work space with backgrounds, borders, colors, fonts, and more.

* Customize your workpad with your own visualizations, such as images and text.

* Pull your data directly from {es}, then show it off with charts, graphs, progress monitors, and more.

* Focus the data you want to display with filters.

image::images/canvas_logWebTrafficWorkpadTemplate_7.17.0.png[Logs Web Traffic workpad template]

[float]
[[create-workpads]]
== Create workpads

A _workpad_ provides you with a space where you can build presentations of your live data. You can create a workpad from scratch, start with a preconfigured workpad, 
import an existing workpad, or use a sample data workpad.

[float]
[[canvas-minimum-requirements]]
=== Minimum requirements

To create workpads, you must meet the minimum requirements. 

* If you need to set up {kib}, use https://www.elastic.co/cloud/elasticsearch-service/signup?baymax=docs-body&elektra=docs[our free trial].

* Make sure you have {ref}/getting-started-index.html[data indexed into {es}] and a <<data-views, data view>>.

* Have an understanding of {ref}/documents-indices.html[{es} documents and indices].

* Make sure you have sufficient privileges to create and save workpads. When the read-only indicator appears, you have insufficient privileges,
and the options to create and save workpads are unavailable. For more information, refer to <<xpack-security-authorization,Granting access to {kib}>>.

To open *Canvas*, open the main menu, then click *Canvas*.

[float]
[[start-with-a-blank-workpad]]
=== Start with a blank workpad

To use the background colors, images, and data of your choice, start with a blank workpad.

. On the *Canvas* page, click *Create workpad*.

. Specify the *Workpad settings*.

.. Add a *Name* to your workpad.

.. In the *Width* and *Height* fields, specify the size, or select one of default layouts. 

.. Click the *Background* color picker, then select the color for your workpad.

[float]
[[create-workpads-from-templates]]
=== Create workpads from templates

If you're unsure about where to start, you can use one of the preconfigured templates that come with *Canvas*.

. On the *Canvas* page, select *Templates*.

. Click the preconfigured template that you want to use.

. Add your own *Name* to the workpad.

[float]
[[import-existing-workpads]]
=== Import existing workpads

When you want to use a workpad that someone else has already started, import the JSON file.

On the *Canvas* page, drag the file to the *Import workpad JSON file* field. 

[float]
[[use-sample-data-workpads]]
=== Use sample data workpads

Each of the {kib} sample data sets comes with a workpad that you can use for your own workpad inspiration.

. Add a <<gs-get-data-into-kibana,sample data set>>.

. On a sample data card, click *View data*, then select *Canvas*.

[float]
[[add-canvas-elements]]
== Add elements

Create a story about your data by adding elements to your workpad that include images, text, charts, and more.

[float]
[[create-elements]]
=== Create elements

Choose the type of element you want to use, then use the preconfigured demo data to familiarize yourself with the element. When you're ready, connect the element to your own data. 
By default, most of the elements you create use the 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.

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

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

* *{es} SQL* &mdash; Access your data in {es} using {ref}/sql-spec.html[SQL syntax].

* *{es} documents* &mdash; Access your data in {es} without using aggregations. To use, select a {data-source} and fields. 
Use *{es} documents* when you have low-volume datasets, and you want to view raw documents or to plot exact, non-aggregated values on a chart.

* *Timelion* &mdash; Access your time series data using <<timelion,*Timelion*>> queries. To use *Timelion* queries, you can enter a query using the <<lucene-query,Lucene Query Syntax>>.
+
Each element can display a different {data-source}, and pages and workpads often contain multiple {data-sources}.

. To save, use the following options:

* To save a single element, select the element, then click *Edit > Save as new element*.

* To save a group of elements, press and hold Shift, select the elements you want to save, then click *Edit > Save as new element*.

To access your saved elements, click *Add element > My elements*.

[float]
[[add-kibana-visualizations]]
=== Add panels from the Visualize Library

Add a panel that you saved in *Visualize Library* to your workpad. 

. Click *Add from library*, then select the panel you want to add.

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

* *Edit map* &mdash; Opens <<maps,Maps>> so that you can edit the panel.

* *Edit Visualization* &mdash; Opens the visualization editor so that you can edit the panel.

* *Panel settings* &mdash; Allows you to change the title, description, and time range for the panel.

* *Inspect* &mdash; Allows you to drill down into the panel data.

[float]
[[add-your-own-images]]
=== Add your own images

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

. Click *Add element > Manage assets*.

. On the *Manage workpad assets* window, drag and drop your images.

. To add the image to the workpad, click *Create image element*.

[float]
[[add-more-pages]]
== Add pages

Organize and separate your ideas by adding more pages.

. Click *Page 1*, then click *+*.

. On the *Page* editor panel, select the page transition from the *Transition* dropdown.

[float]
[[workpad-share-options]]
== Share your workpad

To share workpads with a larger audience, click *Share* in the toolbar. For detailed information about the sharing options, refer to <<reporting-getting-started,Reporting>>.

[float]
[[export-single-workpad]]
== Export workpads

Want to export multiple workpads? Go to the *Canvas* home page, select the workpads you want to export, then click *Export*.

--

include::{kib-repo-dir}/canvas/canvas-edit-workpads.asciidoc[]

include::{kib-repo-dir}/canvas/canvas-present-workpad.asciidoc[]

include::{kib-repo-dir}/canvas/canvas-tutorial.asciidoc[]

include::{kib-repo-dir}/canvas/canvas-expression-lifecycle.asciidoc[]

include::{kib-repo-dir}/canvas/canvas-function-reference.asciidoc[]

include::{kib-repo-dir}/canvas/canvas-tinymath-functions.asciidoc[]
