> For the complete documentation index, see [llms.txt](https://help.iviva.com/lucy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.iviva.com/lucy/gallery-dashboards/adding-widgets-onto-your-canvas.md).
# Adding Widgets onto Your Canvas
Widgets on your Canvas visualise your data in action. Customise your Canvas by adding the Widgets as necessary.
This article shows you the process of adding a widget onto an existing dashboard/canvas.
{% hint style="info" %}
You should have a basic understanding of [canvas creation](/lucy/gallery-dashboards/creating-a-canvas.md) before reading this article.
{% endhint %}
Refer to the below article to gain insights into creating a canvas if you have no idea how to create one.
{% content-ref url="/pages/xBBqFZxICevvrgHY9iZN" %}
[Creating a Canvas](/lucy/gallery-dashboards/creating-a-canvas.md)
{% endcontent-ref %}
There are two ways to add a widget onto a canvas.
1. [Adding a Widget onto Your Canvas](#adding-a-widget-onto-your-canvas)
2. [Adding a Widget from the Widget Designer Page](#adding-a-widget-from-the-widget-designer-page)
Here's an example of a widget: The Current Monthly Energy Usage widget. This widget can be used to display your energy consumption for the current month.
Current Monthly Energy Usage Widget
## Adding a Widget onto Your Canvas
The process of adding a widget directly from your canvas is described in four main steps.
{% hint style="info" %}
You have the flexibility to add multiple instances of the same widget onto your canvas.
{% endhint %}
### 1. Open your Canvas
1. On the Lucy app's **homepage**, click the **Gallery** tab on the sidebar to go to the Gallery.
2. Pick the Canvas from the Gallery to add the widget(s).
3. If there is a list of Canvases on the Gallery, you can search for the required Canvas by typing its name under **Search Canvases**.
4. Click on the Canvas to view it in full, or alternatively, hover over the Canvas and click the **preview** icon to open it.
5. If you have not added any Widgets onto your Canvas yet, you will see the **+** icon . Click the **+** icon. The Widget Browser will open. Alternatively, you can click the **Add Widget** button on the top right to add widgets onto your Canvas.
+ icon and Add Widget button are visible on a freshly created Canvas
### 2. Filter Widgets from the Widget Browser Window
The Widget Browser shows the available widgets for you to add to your Canvas. Already installed widgets will be displayed with a tag stating "**Installed"**.
To Filter and Select Widgets from the Widget Browser:
1. Select the Category from the list displayed on the Sidebar, to see the Widgets belong to the specific Category. Below are some categories you will find:
1. All: Displays all available widgets.
2. My Widgets: Displays the widgets designed by you and others.
3. Facilities Management: Displays the widgets related to Facility Management.
2. You can search for the required Widget by typing the name in the box given on the top as well.
Filter Widgets
### 3. View Widget Preview
On the Widget Browser, click the Preview icon of the required Widget to get more information about the respective Widget. Once the preview icon is clicked, you will see a small preview of the Widget which is interactive.
Preview of a Widget
### 4. Select and Add required Widgets to Canvas
1. Pick the required Widgets by clicking on them. You can even select the Widgets by clicking on the Tick icon related to them.
2. After selecting the required Widgets, click **Add Widgets.**
3. The selected widget(s) will be added onto your Canvas.
Select and Add required Widgets to Canvas
Watch the video demonstrating how to add widgets directly onto your canvas here.
{% embed url="" %}
## Adding a Widget from the Widget Designer Page
The Widget Designer is a user-friendly, no-code interface for designing and customising new user interfaces. You can use it to add required widget to an existing canvas.
To Add a Widget to an Existing Canvas using the Widget Designer:
1. On the Lucy app's **homepage**, click the **My Work** tab on the sidebar.
2. Locate and open your folder.
3. Go to the **User Interfaces** tab.
4. Hover over the desired user interface and click the **Edit** icon. It will open on the widget designer page.
5. Click the **Share** button.
6. Under Add this to a Canvas section, pick the required canvas to add your widget.
7. Click **Add to Dashboard.**
8. Now your widget will be displayed on the respective canvas.
Watch the video below to gain a better understanding of how to add a widget from the Widget Designer Page.
{% embed url="" %}
