> For the complete documentation index, see [llms.txt](https://docs.decube.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decube.io/virtual-sources-and-objects/manage-virtual-sources.md).

# Manage Virtual Sources

Virtual sources live on the **Integrations** page under the **Data Sources** tab, alongside your native connector sources. You can create and manage them entirely from this page.

## Create a virtual source

1. Navigate to **Integrations** and select the **Data Sources** tab.
2. Click the **Create new** button and select **Create a virtual source** from the dropdown.

<figure><img src="/files/VFR2RrCL3ebn2xEEPVVm" alt=""><figcaption></figcaption></figure>

3. Enter a **Name** for the source. The name must be unique across all sources in your workspace.
4. Click **Create** to finish, or click **Add virtual assets** to go directly to the Asset Tree Editor and start building your object hierarchy.

<figure><img src="/files/zChQjdxqpCGuXOqU5HKS" alt=""><figcaption></figcaption></figure>

After creation, the virtual source appears in the Data Sources list with a virtual source icon. The **Children updated at** timestamp on the row updates each time any object under the source is created, edited, or deleted.

### Virtual source landing page

After creation you land on the virtual source page. From here you can start populating the source with objects via:

* **UI** — opens the Asset Tree Editor to build the object hierarchy interactively. See [Manage Virtual Objects](/virtual-sources-and-objects/manage-virtual-objects.md).
* **API** — links to the API reference; the virtual source ID is shown here for use in API calls. See [Virtual Sources](/public-api/overview/index/virtual-sources.md).

You can also connect virtual objects into your lineage graph from their asset detail pages. See [Virtual Sources in Lineage](/virtual-sources-and-objects/virtual-sources-in-lineage.md).

## Edit a virtual source

1. On the **Data Sources** tab, locate the virtual source row and click **Manage**.
2. In the modal, update any of the following fields:
   * **Name**
   * **Description**
   * **Source owner** — defaults to the creator; can be transferred to any other user
   * **Enabled / Disabled** state

Changes take effect immediately on save.

## Enable or disable a virtual source

Disabling a virtual source removes it from Catalog search results and lineage diagrams without deleting it. This behaves the same as enabling and disabling native sources.

Open the **Manage** modal for the source and toggle the enabled state on or off.

{% hint style="warning" %}
Disabling a virtual source hides it and all its objects from the Catalog and lineage graphs. Re-enabling it restores full visibility.
{% endhint %}

## Delete a virtual source

Deleting a virtual source is a **hard delete** — the source and all virtual objects under it are permanently removed from the database.

{% hint style="danger" %}
This action is irreversible. All virtual objects under the source, including their metadata, are permanently deleted.
{% endhint %}

1. Open the **Manage** modal for the virtual source.
2. Click **Delete source** and confirm in the secondary confirmation step.

{% hint style="info" %}
Virtual object deletion works differently — deleting an individual object is a soft delete that removes it from the UI but retains the record in the database. See [Manage Virtual Objects](/virtual-sources-and-objects/manage-virtual-objects.md) for details.
{% endhint %}