Skip to content

Asset Manager

The Asset Manager provides centralized file storage and management for the Portal. Administrators can upload, organize, and manage files that are used across the Portal, including images, documents, theme assets, and page/block screenshots.

The Asset Manager is accessible from the Admin Console under the Asset Manager section and has two tabs: Settings and Files.

Storage Backends

The Asset Manager supports three storage backends:

Local File System

Files are stored on the Portal server's local disk. This is the simplest option and is suitable for single-server deployments.

No additional configuration is required.

S3 Bucket

Files are stored in an Amazon S3 bucket. This is the recommended option for production deployments, as it provides scalable and durable storage.

Configuration:

  • Bucket Name - The name of the S3 bucket.
  • Credentials - An S3 Named Credential containing the AWS Access Key ID and Secret Access Key.

SharePoint

Files are stored in a Microsoft SharePoint document library. This is useful for organizations that use SharePoint for document management.

Configuration:

  • Site URL - The SharePoint site URL (e.g., https://tenant.sharepoint.com/sites/SiteName).
  • Credentials - An Azure Active Directory Named Credential for authentication.

Settings Tab

The Settings tab allows administrators to enable and configure the Asset Manager.

  • Enable - Toggle the Asset Manager on or off.
  • Type - Select the storage backend (Local File System, S3, or SharePoint).
  • Additional fields are displayed based on the selected type. See Storage Backends above.

Changes must be saved before taking effect. A confirmation dialog appears if you navigate away with unsaved changes.

Files Tab

The Files tab provides a file browser for managing Portal assets. It is only visible when the Asset Manager is enabled.

  • Breadcrumb - Click folder names in the breadcrumb trail to navigate to parent directories.
  • Root - The top-level folder is labeled "Portal Assets".
  • View modes - Toggle between grid view (with thumbnails) and list view using the toolbar icons. The preference is saved between sessions.

File Operations

  • Upload - Drag and drop files onto the file browser or click the upload button. Uploaded files appear in the current folder.
  • Download - Select a file and click the download button, or use the right-click context menu.
  • Create Folder - Click the new folder button. If a folder with the same name exists, a number is appended.
  • Rename - Right-click a file or folder and select Rename.
  • Cut / Copy / Paste - Move or copy files and folders using the right-click context menu.
  • Delete - Right-click and select Delete. A confirmation dialog is shown. Deleting a file may break any share URLs that reference it.

Enter at least 3 characters in the search bar to search recursively from the current folder. Results are paginated and can be navigated using the Show in Folder context menu action.

Context Menu

Right-click on a file or folder to access:

  • Show in Folder - Navigate to the containing folder (available in search results).
  • Open - Open a folder.
  • New Folder - Create a new folder in the current directory.
  • Cut / Copy / Paste - Move or copy items.
  • Delete - Remove the item.
  • Download - Download a file.
  • Rename - Rename the item.
  • Details - View file metadata (name, size, last modified).
  • Access - Manage permissions for the item. See Access Control.
  • Share URL - Get a shareable URL for a file.

Access Control

Each file and folder can have access permissions configured through the Access option in the context menu.

Public Access

Toggle public access to make a file available to anyone via its URL, including unauthenticated users. When disabled, only authenticated users can access the file.

Group-Based Access

Use the group picker to restrict access to specific user groups. When no groups are selected, the file is accessible to all authenticated users. When one or more groups are selected, only users in those groups can access the file.

Permissions are inherited from parent folders. A file in a restricted folder inherits the restriction unless it has its own explicit access policy.

System Folders

The Asset Manager reserves certain folders for system use:

  • .zuar/screenshots/layouts - Page screenshots
  • .zuar/screenshots/blocks - Block screenshots
  • .zuar/themes - Theme logos and favicons

These folders are managed automatically and should not be modified manually.

File Browser Block

The File Browser block type allows non-admin users to browse and download files from the Asset Manager. It provides read-only access and respects all configured access permissions.