> For the complete documentation index, see [llms.txt](https://tools.continis.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tools.continis.io/subassets-toolbox/editor-workflows/adding-sub-assets.md). # Adding Sub-Assets ## Drag and drop To add one or more Sub Assets to an existing asset, simply select the ones you want to add and drag them on top of another asset.

Dragging SecondaryMission_1 on top of MainObjective

You will be presented with a popup:

**Add** By choosing to just Add, the dragged asset will be added as a sub-asset to the destination and disappear from its original location.

**Add and Keep Original** By choosing this the original asset will stay in its place, and a new copy will be added to the destination. In this case, all references to the original asset will be preserved.

SecondaryMission_1 is now a sub-asset,
but the original is also preserved

{% hint style="warning" %} It's not possible to add sub-assets to assets that already feature sub-assets as a result of the import process. For instance, adding sub-assets to an **.fbx model** will result in nothing, because as soon as the asset saves, the import process will reset the sub-assets to the default ones. See a list of the types that can't be added as sub-assets on the [Exceptions page](/subassets-toolbox/changelog.md). {% endhint %} ## Create a new sub-asset It is possible to create a new asset directly as a sub-asset. Simply right click on the destination main asset, and use the Create menu:

Using the Create menu while an asset is selected, to create a new Material

Once you select the asset type, the new asset is created and you can give it a name, like usual:

Once the rename is confirmed, the new asset will be added as a sub-asset to the previous selection.

{% hint style="success" %} **Preserving References** When adding a sub-asset using drag and drop, normally the references to the original asset will break. SubAssets Toolbox has a way to prevent this, and you can find more about it in [Patch References](/subassets-toolbox/editor-workflows/patch-references.md). {% endhint %} ## Renaming sub-assets To rename a sub-asset, select it and use **right-click > Rename Sub-Asset**. You can also select it and hit Enter (on Mac) or F2 (on Windows). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://tools.continis.io/subassets-toolbox/editor-workflows/adding-sub-assets.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.