Skip to main content
MediaBeacon University

Manage Workspace Dialog

Options for workspace configuration in the Manage Workspace dialog.


The Manage Workspace dialog controls workspace behavior in most respects.

Dialog Sections


  • "Back" button (left arrow in the dialog's upper left): Cancels changes to workspace configuration.
  • "Done" button: Applies changes to configuration.
    • Note: Adding workspaces in the component sections are added or removed immediately, regardless of clicking "Done".
  • "Search Components" field (in the upper right of the dialog): Text entered here will filter the components displayed in the components sections, see below. 

Component Sections

Four spindown sections are listed here, each a different class of component:

  • Search Components
  • Information Components
  • Action Components
  • View Components

Components can be added to the workspace in these sections, and the "Search Components" field will filter components based upon their name.

Note that some components can have multiple instances present on a workspace, and others cannot. When a component is added to the workspace via the "Add" button, this is indicated as shown below.

  • Single-instance components: The "Add" button becomes a "Remove" button,
  • Multi-instance components will show a "number of instances" indicator (xNumber) to the left of the "Add" button.
    • Note that to remove multi-instance components, this must be done outside of the Manage Workspace dialog, by clicking the "X" button on the component's title bar while in admin mode.

Layout & Theme

The Layout section allows the user to choose between different arrangements of layout zones for the workspace. The "Default header footer" is the most flexible of these and is the most commonly used.

  • Recommended Layout: Default Header footer
  • Other Layouts: Default, Default header widget, Single column, Single column view, Three by two, Two column, Two column header footer, Vertical columns

Note that when a layout is changed, the components may be rearranged.


This area has been substantially simplified in MediaBeacon 2018.0 and greater, now showing a single toggle control to use the Dark Theme.

Workspace Options

Styling Options

  • Hide Menu Bar: Hides the menu bar on the workspace. This option is disabled by default.
  • Hide Workspace Tabs: Hides the workspace tabs. This option is enabled by default.
  • Theme Color: This changes the "primary" color of the workspace: button color, toggle color, folder and asset selection color, etc.
  • Menu Bar Background Color: This color selector allows the admin to choose a different background color for the menu bar. Note that the text will automatically change to a contrasting greyscale color, and that the pulldown menus themselves remain as the theme color dictates.
  • Home Button Icon: An icon may be chosen here, using the standard icon picker. The home button displays at 140x38px, and the icon will scale to fit within that area.
  • Workspace Icon: An icon chosen here will be displayed next to the name of the workspace in the Navigate Menu and the workspace tab.
  • Custom CSS Classes: Strings entered here become CSS classes on the body tag of the current workspace.
  • Browser's Window Title: A string entered here becomes the browser tab label.

URL Options

Note: These options are not commonly used in most installations of MediaBeacon.

  • Custom URL for Workspace: A string entered here acts as a redirect to the given workspace, for example: "" might resolve to "!MP;;p=464EBF9D-94E5-419B-A741-7EC76D9A2EE9;;par=0=1=50". The custom URL does not function as a "vanity URL", the workspace's URL remains the same. Note that users who follow such a link cannot be shown workspaces to which their ACL's do not have access.
  • Custom Login URL: A URL entered here will cause MediaBeacon to redirect the user to that URL with the user accesses MediaBeacon in a non-logged in state. This can be after logging out, but also connecting to MediaBeacon while not logged in. This behavior is dependant upon what workspace the user last used, which is stored in a browser cookie.
  • Custom Link URL for Emails: A partial URL entered here can redefine the URL sent via email mechanisms in the system. This can be useful if your MediaBeacon instance has a different external DNS assignment then internal to your network.

Default Behavior Options

  • Always show floating general tab: This option causes the "General" tab to persistently display below the image preview in the Asset View.
  • Zip Quick Downloads: Enabled by default, this option sets the default behavior for Quick Downloads. When disabled, quick downloaded assets will be automatically decompressed, no ZIP file being left behind. Note: this behavior only pertains to the Quick Download function, not the Download function.
  • Set Default Download File Name: When multiple assets are downloaded at once, they are combined into one ZIP file with the name "". A string entered here changes this name for downloads from the workspace being configured.
  • Default Asset View Metaform: A single metaform may be designated as the default metaform which will be expanded when the user opens the asset view. This metaform can not be removed from the asset view, and will always be displayed when browsing to a new asset from within the asset view (using the next and previous buttons). Note: Although a global administrator may choose any metaform for this field, the ACL's "Visible Metaforms" entries have precedence. The upshot being that if the Default Asset View Metaform is not in the ACL's Visible Metaforms list, it will not be displayed.
  • Default Asset View Tabs: Multiple metaforms may be designated as "default tabs". These metaforms tabs will always be listed in the metadata panel of the asset view, and cannot be removed. Note: Although a global administrator may choose any metaforms for this field, the ACL's "Visible Metaforms" entries have precedence. The upshot being that if a Default Asset View Tab is not in the ACL's Visible Metaforms list, it will not be displayed.
  • Required Metaforms for Upload: One or more metaforms may be chosen for this entry, becoming the upload metaform used for all uploads in this workspace. This setting will supercede the ACL upload metaform setting, and is overridden by upload metaform settings in components. Component upload metaform settings only pertain to uploads initiated by clicking or asset-dragging directly on that given component. The upshot is that the Create > Menu command's upload metaform behavior can be controlled only with the ACL or workspace "Upload Metaform" setting. Of special note: metaforms chosen here are NOT restricted by the ACL's "Upload Metaform" setting; therefore a workspace can use an upload metaform that is not otherwise visible to the user in asset view.
  • Fields On Asset View General Tab: Fields chosen here are displayed at the bottom of the "General" tab in the asset view. At least one must be specified. Any field may be chosen, and is not limited to fields that the ACL has in any "Visible Metaform". Note: Adding a field here will make that field editable by the user, unless the user's Group "Edit Level" setting is lower that the given field.
  • Fields below Asset Link: Fields chosen here will be visible in the asset preview pane of the "Asset Links" metaform tab. Note: Adding a field here will make that field editable by the user, unless the user's Group "Edit Level" setting is lower that the given field.

Advanced JavaScript Options

The following areas allow JavaScript code (using MediaBeaconJavaScript API) to replace the function of certain actions in the interface.

Note that if these sections are turned off via the right-hand toggle button, the contents will be deleted.

  • Enable javascript on direct download: Code entered here replaces the function of all download actions on a workspace, except those in the Notification Center.
  • Enable javascript in the asset view: Code entered here replaces the function of opening the asset view.
  • Enable javascript on home button click: Code entered here replaces the function of the home button. This is sometimes used to change this interface element to navigate to a specific workspace, rather than clearing search criteria.
  • Notification Center Options: Enable javascript on direct download: Replaces the function of download actions in the Notification Center. Note that this includes conversion downloads that use the "Download on conversion complete" option in their Loading Dock conversion preset.
  • Was this article helpful?