--- title: "Custom Assets Administration" slug: "custom-assets-administration" updated: 2025-09-25T22:14:41Z published: 2025-09-25T22:14:41Z canonical: "docs.unqork.io/custom-assets-administration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.unqork.io/llms.txt > Use this file to discover all available pages before exploring further. # Custom Assets Administration The **Custom Assets Administration** page enables Creators to upload packages containing custom [components](/v1/docs/bring-your-own-byo-custom-component), [events](/v1/docs/bring-your-own-byo-custom-events), and [operations](/v1/docs/bring-your-own-byo-custom-operations) for their Unqork environments. After installing a package, Creators can use the package's contents in the [Module Builder](/v1/docs/introduction-to-the-module-builder) as they would an Unqork component, operation, or event. > Learn how to build custom assets in our [Introduction to the Bring Your Own (BYO) Framework](/v1/docs/introduction-to-the-bring-your-own-byo-framework) article. ## Custom Assets Administration Page In this section, you'll learn how to access and use the Custom Assets Administration page. Creators must have administrator access to view and use this page. ### Navigating to the Custom Assets Administration Page To access the Custom Assets Administration page: 1. From the Homepage, click **Administration**. 2. Under ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(35).png?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) Assets, click **Custom Assets Administration**. ### Understanding the Custom Assets Administration Page The Custom Assets administration page is separated into the following sections: - **Packages**: Displays a list of packages uploaded to the environment. Administrator Creators can view the package's details and assets. > [!NOTE] > All BYO Assets are created and managed at the package level. A package can contain one or more components, events and operations. - **Assets**: Displays a list of individual assets in the environment across all packages. Administrator Creators can view each asset's details. Click on the tabs below to learn more about each section: PackagesAssets ## Packages [![A static image displaying the Custom Assets Administration page.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/customAssetsAdmin_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/customAssetsAdmin.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) | # | Setting | Description | | --- | --- | --- | | 1 | **+ Create New** | Click this button to create a new package or asset. | | 2 | **Packages/Assets Tab** | Displays the Custom Assets **Packages** or **Assets** list. | | 3 | Active (Filter) | Filters the Packages List to the following package types: - **Active**: Displays packages that are active in the environment. - **Deleted**: Display packages that have been removed from the environment. | | | **Packages List** | Displays a list of packages in the environment, including their version, description, and the **Actions** button. | | 4 | **Name** | The package's name as defined in the [BYO manifest.json file](/v1/docs/bring-your-own-byo-understanding-the-manifestjson-file). | | 5 | **Version** | The package's current version. This value is defined by the creator of the BYO package. | | 6 | **Description** | A short description of the package's contents. | | 7 | **Actions** | Click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) (**ellipsis**) button to display the following settings: - **View**: Opens the view package **modal**. This modal displays the package's info and the assets contained inside. - **Delete**: Displays the deletion modal. Click **Delete** to permanently delete the package. > [!TIP] > View deleted packages by changing the Active (filter) drop-down to **Deleted**. | ## Assets [![A static image displaying the Custom Assrts Administration's Assets list](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/customAssetsAssets_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/customAssetsAssets.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) | | Setting | Description | | --- | --- | --- | | 1 | Active (Filter) | Filters the Assets List to the following asset types: - **Active**: Displays assets that are active in the environment. - **Deleted**: Display assets that have been removed from the environment. | | | **Assets List** | Displays a list of assets in the environment, including the package they came from, the type of asset, a description, and the option to view the asset's details. | | 2 | Name | The name of the asset as defined in the [BYO manifest.json file](/v1/docs/bring-your-own-byo-understanding-the-manifestjson-file). | | 3 | Parent Package | The name of the package that contains this asset. Multiple assets might have the same parent package. | | 4 | Type | The asset type. The current assets types are: - **C****omponent**: A [BYO Custom Component](/v1/docs/bring-your-own-byo-custom-component) available in the environment's [Module Builder](/v1/docs/introduction-to-the-module-builder). - **E****vent**: A [BYO Custom Event](/v1/docs/bring-your-own-byo-custom-events) available in the Module Builder's [Operations Builder tool](/v1/docs/introduction-to-the-operations-builder). - **O****peration**: A [BYO Custom Operation](/v1/docs/bring-your-own-byo-custom-operations) available in the Module Builder's [Operations Builder tool](/v1/docs/introduction-to-the-operations-builder). | | 5 | Description | The asset's name as defined in the [BYO manifest.json file](/v1/docs/bring-your-own-byo-understanding-the-manifestjson-file). | | 6 | View | Click **View** to open the view package **modal**. This modal displays the package's info and the asset details. | ## Creating, Viewing, and Deleting Asset Packages Administrator Creators use the Custom Assets Administration page to upload, view, or delete packages containing assets. > Individual assets cannot be modified or promoted. > > - To update one or more assets in a package, delete the existing package and upload a new version. > - To promote a package and its assets, upload it to the destination environment's Custom Assets Administration page. > > For more information, view the Package Management section of our [BYO Best Practices](/v1/docs/best-practices-bring-your-own-byo-framework#byo-package-management) article. Click on the tabs below to learn more about creating, viewing, and deleting packages: CreateViewDelete ## Creating a New Asset Upload packages containing assets using the Create New Asset modal. After uploading and verifying a package's content, the assets become available in the Unqork Designer Platform for Creators. To create a new asset from the Custom Assets Administration page: 1. Click **+ Create new**. The **Create Asset** modal displays. 2. Under File Upload, click or drag a BYO package from your local device to the upload window. 3. Click **Scan File**. The package details display. [![A static image displaying the Create Asset modal.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/uploadAsset_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/uploadAsset.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) > [!NOTE] > If an import error occurs, review the package's contents for errors and name mismatches. 4. Click **Review Assets**. 5. Review the asset's details, including **C****omponents**, **E****vents**, and **O****perations**. 6. Click **Confirm & Create**. 7. Review the **Library Usage Acknowledgment and Liability Agreement**. Click the **☐** (**checkbox**) to acknowledge the agreement. 8. Click **Create Asset**. The asset package displays in the Custom Assets’ **Packages** list. The package's individual assets display in the Assets tab's **Assets** list. The assets are now available in the Module Builder for all applications in the environment. ## Viewing a Package's Content View a package's content, including package details and assets details. To view a package's contents from the Custom Assets Administration page: 1. In the **Packages** list, navigate to a package. 2. In the **Actions** column, click the package's (**ellipsis**) button. 3. Click **View**. The Package Content modal displays. 4. Inspect the **1. Info** tab's package details. [![A static image displaying the Package Details modal.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/viewPackageDetails_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/viewPackageDetails.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) 5. Click **Review Assets** or the **2. Assets** tab. 6. Inspect the package's assets, including Components, Events, and Operations. [![A static image displaying a Package's Asset details.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/viewPackageAssetDetails_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/viewPackageAssetDetails.jpg?sv=2026-02-06&spr=https&st=2026-11-06T22%3A54%3A32Z&se=2026-11-06T23%3A54%3A32Z&sr=c&sp=r&sig=mK6Bdiz6aarY5sHtE819ZyjqiDHcINyHiPrzv0iFkt8%3D) 7. Click **Cancel**. > [!TIP] > To view an individual asset's details, open the Custom Asset Administration's **Assets** tab, find the custom asset, then click View. ## Deleting a Package Deleting a package removes its assets from the environment. Consider the following when deleting a package: - Deletion occurs at the package level. Deleting a package removes all assets, including the component, events, and operations. - If required, deleted assets must be manually removed from module definitions. Reference the **Used in** **Module** list when viewing the details of a deleted asset. - In the Custom Assets Administration screen, administrators can view deleted packages and assets by selecting the **Deleted** filter. To delete a package's contents from the Custom Assets Administration page: 1. In the **Packages** list, navigate to a package. 2. In the **Actions** column, click the package's (**ellipsis**) button. 3. Click **Delete**. 4. Review the confirmation modal, then click **Delete**. > [!TIP] > To view a delete package's details, change the Active (Filter) drop-down to **Deleted**. ## Resources ### [Introduction to the Bring Your Own (BYO) Framework](/v1/docs/introduction-to-the-bring-your-own-byo-framework) Get started building your own custom assets, including components, events, and operations. ### [Introduction to the Operations Builder](/v1/docs/introduction-to-the-operations-builder) Set and connect events and operations to components. ### [BYO Best Practices](/v1/docs/best-practices-bring-your-own-byo-framework) Learn about best practices for implementing and using BYO assets. ### [BYO General FAQ](/v1/docs/bring-your-own-byo-general-faq-frequently-asked-questions) Learn about the Bring Your Own Framework and discover frequently asked questions. Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.