kibana/docs/canvas/canvas-workpad.asciidoc
Kaarina Tungseth b306c5b8f4
[DOCS] Create Canvas workpads (#38616)
* Create workpads (in Canvas)

* Continuing work on intro

* Share your workpad content

* Reorganization

* Added GIFs

* Final clean up

* Comments from reviewers

* Comments from Gail
2019-07-09 12:59:42 -05:00

72 lines
2.3 KiB
Plaintext

[role="xpack"]
[[canvas-workpad]]
=== Create a workpad
When you create a workpad, you'll start with a blank page, or you can choose a workpad that is already started for you.
. Open *Canvas*.
. Choose one of the following options:
* To start with a single, blank workpad, click *Create workpad*.
* To create a workpad from a template, select *Templates*, then select a preconfigured template.
* To import an existing workpad, click and drag a workpad JSON file to the *Import workpad JSON file* field.
For advanced workpad examples, add a {kibana-ref}/add-sample-data.html[sample Kibana data set], then select *Canvas* from the *View Data* dropdown list.
For more workpad inspiration, go to the link:https://www.elastic.co/blog/[Elastic Blog].
[float]
=== Personalize your workpad
To personalize your workpad, use the editor on the right.
. Add a *Name* to your workpad, for example, `My Canvas Workpad`.
. In the *Width* and *Height* fields, specify the size of your workpad.
. Select the layout for your workpad.
+
For example, click *720p* for a traditional presentation layout.
. Click the *Background color* picker, then select the background color for your workpad.
+
image::images/canvas-background-color-picker.gif[]
. If you already know that you want to apply styles to the entire workpad, use the *Global CCS overrides*.
.. Expand *Global CCS overrides*.
.. Enter the CCS, then click *Apply stylesheet*.
[float]
=== Share your workpad
When you are ready to share your workpad, create a PDF, or export your workpad to another author.
[float]
==== Create a PDF of your workpad
To view your workpad outside of Kibana, generate a PDF.
. If you are using a basic license, enable reporting in your `config/kibana.yml` file.
. From your workpad, click the *Share workpad* icon in the upper left corner, then select *PDF reports*.
. Click *Generate PDF*.
+
image::images/canvas-generate-pdf.gif[]
[float]
==== Export your workpad
To share your workpads with another author, export your workpads as JSON files.
. Go to the *Canvas workpads* page.
. Choose one of the following options:
* To export a single workpad, click the *Export* icon next to the workpad you want to export.
* To export multiple workpads, select the workpads you want to export, then click *Export*.