---
title: Creating and Managing MetaBlocks
description: "This chapter describes how to view, create, edit, and delete a MetaBlock. ## Viewing MetaBlocks The **MetaBlocks**page (Left menu > MetaBlocks icon) displays information about existing MetaBlocks. ![https://lucidum.cloud/docs/metablocks_page_25.0.png](https://lucidum.cloud/docs/metablocks_page_25.0.png) - ***Name***. Name of the MetaBlock. - ***Description***. Description of the MetaBlock…"
url: "https://lucidum.io/docs/creating-and-managing-metablocks/"
updated: "2025-12-17"
category: MetaBlocks
---

# Creating and Managing MetaBlocks

This chapter describes how to view, create, edit, and delete a MetaBlock.

## Viewing MetaBlocks

The **MetaBlocks**page (Left menu > MetaBlocks icon) displays information about existing MetaBlocks.

![https://lucidum.cloud/docs/metablocks_page_25.0.png](https://lucidum.cloud/docs/metablocks_page_25.0.png)

- ***Name***. Name of the MetaBlock.
- ***Description***. Description of the MetaBlock
- ***Dependencies***. These icons represent objects in Luciudm (Dashboards, Connectors, Actions, SmartLabels, Saved Queries) and displays the number of each type of object aligned with the MetaBlock. For details, see [Viewing All Content in a MetaBlock](https://lucidum.io/docs/creating-and-managing-metablocks/#from-the-metabocks-page)
- ***Created On***. Date and time the MetaBlock was created.
- ***Created By***. Lucidum user who created the MetaBlock.
- ***Actions***. Tasks to manage each MetaBlock.
  - *Edit*. You can edit the description of a MetaBlock.
  - *Delete*(trashcan) icon. Deletes the MetaBlock.
    **NOTE**: You cannot delete a MetaBlock that includes aligned objects. To delete the MetaBlock, you must first unalign the objects. For details on unaligning objects from a MetaBlock and deleting a MetaBlock, see [Deleting MetaBlocks](https://lucidum.io/docs/creating-and-managing-metablocks/#deleting-metablocks).

## Creating MetaBlocks

1. Navigate to the **MetaBlocks**page (Left menu > MetaBlocks icon).
2. Click the **Add MetaBlock**icon (plus-sign) in the upper right.
   ![metablocks_add_metablock_25.0.png](https://lucidum.cloud/docs/metablocks_add_metablock_25.0.png)
3. In the **Add MetaBlock**page, enter the following in the top pane:
   - ***Name***. Name of the MetaBlock. Must be unique among all MetaBlocks.
   - ***Description***. Description of the MetaBlock.

   **NOTE**: You cannot edit the ***Name*** or ***Description***of a MetaBlock. Be sure to use a name and description that are helpful and easily understood.

## Adding and Deleting Actions to MetaBlocks

For details, see: [Adding Actions to MetaBlocks](https://lucidum.io/docs/overview-of-actions/#adding_and_deleting_actions_to_metablocks) and [Deleting Actions from MetaBlocks](https://lucidum.io/docs/overview-of-actions/#deleting_an_action_from_metablock) in the ***Actions***manual.

## Adding and Deleting Connectors to MetaBlocks

For details, see: [Adding Connectors to MetaBlocks](https://lucidum.io/docs/using-connectors/#adding-connectors-to-metablocks) and [Deleting Connectors from MetaBlocks](https://lucidum.io/docs/using-connectors/#deleting-connectors-from-metablocks) in the ***Connectors***manual.

## Adding and Deleting Dashboards to MetaBlocks

For details, see: [Adding Dashboards to MetaBlocks](https://lucidum.io/docs/using-metablocks-with-dashboards/#adding_dashboards_to_metablocks) and [Deleting Dashboards from MetaBlocks](https://lucidum.io/docs/using-metablocks-with-dashboards/#deleting_a_dashboards_from_metablock) in the ***Dashboards***manual.

## Adding and Deleting Saved Queries to MetaBlocks

For details, see: [Adding Saved Queries to MetaBlocks](https://lucidum.io/docs/using-metablocks-with-saved-queries/#adding_saved_queries_to_metablocks)and [Deleting Saved Queries from MetaBlocks](https://lucidum.io/docs/using-metablocks-with-saved-queries/#deleting_a_saved_query_from_metablock) in the ***Using Queries***manual.

## Adding and Deleting SmartLabels to MetaBlocks

For details, see: [Adding SmartLabels to MetaBlocks](https://lucidum.io/docs/using-metablocks-with-smartlabels/#adding_smartlabels_to_metablocks) and [Deleting SmartLabels from MetaBlocks](https://lucidum.io/docs/using-metablocks-with-smartlabels/#deleting_a_smartlabel_from_metablock) in the ***Streamlining Queries with SmartLabels and Tags*** manual.

## Viewing All Content in a MetaBlock

There are two way to view the content aligned with a MetaBlock:

- From the MetaBlock page, you can view all content in a MetaBlock.
- From the Query Tool, you can view the SmartLabels in a MetaBlock.

### From the MetaBocks page

The **MetaBlocks**page (Left menu > MetaBlocks icon) displays information about existing MetaBlocks, including all the Lucidum objects aligned with the MetaBlock.

To view the objects aligned with a a MetaBlock:

1. Navigate to the **MetaBlocks** page (Left menu > MetaBlocks icon).
   ![metablocks_page_callouts_25.0.png](https://lucidum.cloud/docs/metablocks_page_callouts_25.0.png)
2. Find the MetaBlock you are interested in.
3. The ***Dependencies***column includes icons with a count number. The count number indicates the number of objects aligned with the MetaBlock.
   1. Dashboards
   2. Connectors
   3. Actions
   4. SmartLabels
   5. Saved Queries
4. Clicking on the **Dashboards** dependencies icon displays the **View Dashboard Dependencies for MetaBlocks** modal page:
   ![metablocks_view_dashboad_dependencies_25.0.png](https://lucidum.cloud/docs/
   metablocks_view_dashboad_dependencies_25.0.png)
5. The **View Dashboard Dependencies for MetaBlocks**page displays the following:
   - ***Type***. The icon for dashboard dependencies.
   - ***Dependency Name***. Name of the dashboard aligned with the MetaBlock. Clicking on the link loads the dashboard.
   - ***Created By***. Lucidum user who created the dashboard.
6. Clicking on the **Connectors**dependencies icon displays the **View Connector Dependencies for MetaBlocks** modal page:
   ![metablocks_view_connector_dependencies_25.0.png](https://lucidum.cloud/docs/
   metablocks_view_connector_dependencies_25.0.png)
7. The **View Connector Dependencies for MetaBlocks**page displays the following:
   - ***Type***. The icon for connector dependencies.
   - ***Dependency Name***. Name of the connector aligned with the MetaBlock. Clicking on the link leads to the [Connector](https://lucidum.io/docs/using-connectors/#viewing_details_about_a_single_connector_profile) page, with the aligned profile highlighted.
   - ***Created By***. Lucidum user who created the connector profile.
8. Clicking on the **Actions**dependencies icon displays the **View Action Dependencies for MetaBlocks** modal page:
   ![metablocks_view_action_dependencies_25.0.png](https://lucidum.cloud/docs/
   metablocks_view_action_dependencies_25.0.png)
9. The **View Actions Dependencies for MetaBlocks**page displays the following:
   - ***Type***. The icon for action dependencies.
   - ***Dependency Name***. Name of the action aligned with the MetaBlock. Clicking on the link leads to the [Actions](https://lucidum.io/docs/overview-of-actions/#viewing-the-configured-actions-page) page, with the aligned profile highlighted.
   - ***Created By***. Lucidum user who created the configured action.
10. Clicking on the **SmartLabel** dependencies icon displays the **View SmartLabel Dependencies for MetaBlocks** modal page:
    ![metablocks_view_smartlabel_dependencies_25.0.png](https://lucidum.cloud/docs/
    metablocks_view_smartlabel_dependencies_25.0.png)
11. The **View SmartLabel Dependencies for MetaBlocks**page displays the following:
    - ***Type***. The icon for SmartLabel dependencies.
    - ***Dependency Name***. Name of the SmartLabel aligned with the MetaBlock. Clicking on the link leads to the [Edit SmartLabel](https://lucidum.io/docs/creating-and-managing-smart-labels/#editing_a_smartlabel) page, loaded with information from the selected SmartLabel.
    - ***Created By***. Lucidum user who created the SmartLabel.
12. Clicking on the **Saved Query**dependencies icon displays the **View Saved Query Dashboard Dependencies for MetaBlocks** modal page:
    ![metablocks_view_saved_query_dependencies_25.0.png](https://lucidum.cloud/docs/
    metablocks_view_saved_query_dependencies_25.0.png)
13. The **View Saved Query Dependencies for MetaBlocks**page displays the following:
    - ***Type***. The icon for Saved Query dependencies.
    - ***Dependency Name***. Name of the Saved Query aligned with the MetaBlock. Clicking on the link opens the [Edit Query](https://lucidum.io/docs/saved-queries-and-historical-queries-2/#editing-a-saved-query) page, loaded with information from the selected Saved Query
    - ***Created By***. Lucidum user who created the Saved Query.

### From the Query Tool

You can view the SmartLabels in a MetaBlock from the Query Tool. To do so:

1. Click the **Query** button in the upper right of any page in Lucidum or see [Accessing the Query Tool](https://lucidum.io/docs/creating-queries-2/#creating-a-query-from-the-query-button) for other ways to access the Query Tool.
2. In the Build a Query page, specify the ***Type of Data*** and ***Time Range***. For details, see see [Accessing the Query Tool](https://lucidum.io/docs/creating-queries-2/#creating-a-query-from-the-query-button).
3. Click **Next**.
4. In the **Building a Query** page, click the ***Field*** field.
   ![metablocks_in_query_tool_26.0.png](https://lucidum.cloud/docs/metablocks_in_query_tool_26.0.png)
5. In the ***Categories*** bar, select *MetaBlocks*.
6. The **Query Tool** displays the SmartLabels in each MetaBlock.
7. Clicking on a SmartLabel or a Saved Query in a MetaBlock loads the selected SmartLabel or Saved Query in the Query Tool.

## Deleting MetaBlocks

To delete a MetaBlock:

1. Go to the **MetaBlocks**page (Left menu > MetaBlocks icon).
2. Find the MetaBlock you want to delete.
3. Click the **Delete** (trashcan) icon.
   ![metablocks_page_deleting_25.0.png](https://lucidum.cloud/docs/metablocks_page_deleting_25.0.png)

   **NOTE**: You cannot delete a MetaBlock that includes aligned Actions, Connectors, Dashbords, Saved Queries, or SmartLabels. To delete the MetaBlock, you must first unalign all aligned items. You can use the [Dependencies](https://lucidum.io/docs/creating-and-managing-metablocks/#from-the-metabocks-page) column to quickly navigate to each dependency.
4. For details on deleting items from a MetaBlock, see:
   - *Deleting Actions*. [Deleting Actions from MetaBlocks](https://lucidum.io/docs/overview-of-actions/#deleting_an_action_from_metablock) in the ***Actions***manual.
   - *Deleting Connectors*. [Deleting Connectors from MetaBlocks](https://lucidum.io/docs/using-connectors/#deleting-connectors-from-metablocks) in the ***Connectors***manual.
   - *Deleting Dashboards*. [Deleting Dashboards from MetaBlocks](https://lucidum.io/docs/using-metablocks-with-dashboards/#deleting_a_dashboards_from_metablock) in the ***Dashboards***manual.
   - *Deleting Saved Queries*. [Deleting Saved Queries from MetaBlocks](https://lucidum.io/docs/using-metablocks-with-saved-queries/#deleting_a_saved_query_from_metablock) in the ***Using Queries***manual.
   - *Deleting SmartLabels*. [Deleting SmartLabels from MetaBlocks](https://lucidum.io/docs/using-metablocks-with-smartlabels/#deleting_a_smartlabel_from_metablock) in the ***Streamlining Queries with SmartLabels and Tags*** manual.
5. **Best practice** is to[create a new MetaBlock](https://lucidum.io/docs/creating-and-managing-metablocks/#creating-metablocks), assign the same dependencies to the new MetaBlock as are assigned to the MetaBlock you want to delete, and then delete the dependencies from the older MetaBlock.
