Hubs

Hubs

  • Hubs Foundation
  • Docs
  • GitHub
  • Help

›Setting Up Your Hub

Introduction

  • Welcome
  • Getting Started With Hubs
  • Building Scenes with Spoke
  • Creating Custom Avatars
  • Hosting Events in Hubs

Setting Up Your Hub

  • Beginner’s Guide to CE
  • Set up SMTP email service
  • Download and install doctl
  • What’s next?
  • Troubleshooting and FAQs
  • How to back up your Hubs instance
  • Managing Your Hub's Content
  • Frequently Asked Questions
  • Contact Us

Hubs Fundamentals

  • Create and Join Rooms
  • Hubs Features
  • Sharing Avatar Links Privately
  • User Settings
  • Room Settings
  • Controls
  • Discord Bot
  • Troubleshooting
  • FAQ

Spoke Documentation

  • Create Project
  • User Interface
  • Spoke Controls
  • Adding Content
  • Architecture Kit
  • Grid
  • Skyboxes
  • Lighting and Shadows
  • Physics and Navigation
  • Publish Scenes

For Creators

  • Advanced Avatar Customization
  • Linking Hubs Rooms
  • Using the Blender glTF Exporter
  • Blender Add-on Components
  • Optimizing Scenes
  • Introduction to Behavior Graphs

For Developers

  • System Overview
  • Build a Custom Client
  • Contributing
  • Hubs Query String Parameters
  • GitHub Workflows

Hubs Client development

  • Hubs Client development Basics
  • Core Concepts for Gameplay Code
  • Hubs Client development Interactivity
  • Hubs Client development Networking

Hubs Admin Panel

  • Introduction
  • Getting Started
  • Importing Content
  • Customizing Themes
  • Managing Content
  • Adding Administrators
  • Limiting Access
  • Recipe: Permissive Rooms
  • Recipe: Enable Scene Editor
Edit

Managing Your Hub's Content

This page serves as a manual for many of the features that are available to Hubs users to manage the content on their Hub.

Table of Contents
      Introduction
      Default Content
      Importing and Migrating Content
      Managing Scenes and Avatars
      Managing Content Storage
      Accounts and Identities
      Projects
      Logos and Brand Themeing
      App Settings


Introduction

This page references the two tools you can use to manage your hub's content: The Admin Panel and our scene editor, Spoke. Both can be accessed in the top-right corner of your subscription dashboard.

Admin homepage

The Admin Panel is a dashboard that allows you to control your hub's default appearance and features, as well as the discoverability of scenes and avatars uploaded to your server. When you create a new hub, the email associated with your subscription will be the only account with access to the admin panel. You can, however, allow others to access the admin panel using the Accounts tab.

Admin homepage

Spoke is our in-browser scene editor that allows you to upload media (3D models, videos, audio, images, etc.) and build custom environments that your hub's visitors can explore. By default, all users joining your server can use Spoke (and upload their own media), however you can modify this default behavior by using the App Settings "Features" tab to toggle the "Scene Editor".

Spoke homepage

Together, the Admin Panel and Spoke allow you to fully control the content that users may encounter when joining your Hub.


Default Content

Each new hub comes with a selection of logos, themes, scenes, and avatars that have been developed by the Hubs team. To learn how to remove these default assets, see Managing Content Storage.

The default avatars

The default scenes


Importing and Migrating Content

The Import Content tool on the Admin Panel makes it easy to share and rehost assets developed by Hubs or other members of the Hubs community.

Import content tab

It is important to note that only a few url types are supported by the import tool...

  • Hosted Avatar Urls (ex. yourdomain.com/avatars/4Ka33qb)
  • Hosted Scene Urls (ex. hyourdomain.com/scenes/Rpt8DJS)
  • Hosted .pack files (ex. raw.githubusercontent.com/hubs/master/asset-packs/avatars-animals.pack)

How to Use the "Import Content" Tool

  1. Copy and paste the link(s) to the asset(s) you would like to import and select "Preview Import".
  2. In the import preview, verify that the asset thumbnail looks correct and select any tags you would like to apply to the asset (for more on asset tags, see Managing Scenes and Avatars - Asset Tags).
  3. Select "Import" and wait for the assets to be rehosted.

Managing Scenes and Avatars

The Admin Panel is used to manage any scenes or avatars that have been uploaded to your hub. In the left-hand toolbar, you can see eight tabs corresponding to scenes and avatars...

The default avatars

Each of these tabs filters assets based on their state and tags. At the top of each tab, you can search by id or name to see if any assets are included in that category.

The default avatars

Asset State

Asset State is the primary method of controlling a piece of media's discoverability. An asset can have any of four states...

  • Active - the asset will appear in "Approved" tab and be discoverable to users browsing in-world.
  • Pending - the asset will appear in the "Pending" tab and cannot be discovered by any users.
  • Delisted - the asset will only appear in "Scenes" or "Avatars" tab and cannot be discovered by any users other than the one who uploaded it.
  • Removed - the asset is removed from the database and is not usable by anyone.

An example of state

By default, any assets uploaded by users who select "Allow Hubs to promote my scene/avatar" in Spoke or in-world using the "Create Avatar" button will be assigned the "Pending" state and await admin approval in the "Pending" tab before being made discoverable. While "Pending", the user who uploaded the asset can still access it.

An asset uploaded via spoke for approval

Any assets uploaded via the admin panel are automatically assigned the "Active" state, including them in the "Approved" tab and making them discoverable to other users.

Asset Tags

Asset tags allow you to control how discoverable an "Active" asset is. To edit tags, an asset's state must be "Active", including the asset in the "Approved" tab of the admin panel. There are three tags you can add to an asset...

  • featured - The asset appears on the "Featured" tab of both the Admin Panel and when users are browsing scenes and avatars in world.
  • default - A user joining as an avatar for the first time or creating a room using the "Create A Room" button will be the randomly choose from all assets with the "Default" tag.
  • base (for Avatars only) - User can reskin this avatar asset with their own uploaded image. Re-skinned avatars uploaded as unique avatar assets, which can then be controlled in the admin panel.

Asset tags are case-sensitive, so be sure to use the exact spelling and capitalization seen above.

Examples of tags applied to avatars

Asset Order

Assets with the "Featured" tag can be given an order number to control the sequence in which they are displayed to users browsing for scenes and avatars. Order filters from low-to-high, meaning any asset with the order number "1" will be displayed first. Two assets can be given the same order number; if two assets have the same order number, the most recently uploaded asset will display first.

Order control form

Asset Description and Attribution

To properly describe and credit creators of a certain asset, you can add in description and attribution details that will display whenever a user is encountering that asset.

Description for assets.


Managing Content Storage

As you upload content to your hub, you are adding more items to the server's database that contribute to the your hub's content storage limit.

Content storage

The largest contributors to content storage are media used to build environments in Spoke, as well as any avatars and scenes you have rehosted using the "import content" tool on the Admin Panel. Room urls, user accounts, and spoke projects also contribute to the usage limit, but to a lesser degree.

In addition to regularly checking your usage limit, there are a number of features you can disable in App Settings to limit users' ability to upload files, decreasing the risk of unexpected data build-up. Specifically look at the Features and Room Settings

You can also lower your content storage by removing unwanted assets in Spoke and the Admin Panel. PLEASE NOTE: When removing assets with the following methods, it may take up to 3-days for your subscription dashboard to update your content usage.

Deleting Assets In Spoke

Assets in Spoke are associated with individual email accounts (you will not be able to delete the assets of another user if you do not have access to their email account).

  1. After signing-in to Spoke, go into any project and locate the assets interface in the bottom of the screen.

Spoke asset interface

  1. Click on the "My Assets" tab in the lefthand toolbar. From here you can sort by asset type and right click on any asset you wish to delete. In the pop-up, click "Delete Asset" to remove it from the database.

Deleting assets in spoke

Deleting Assets In The Admin Panel

  1. Navigate to the "Scenes" or "Avatars" tabs in the left-hand toolbar.
  2. Click "Edit" on any avatar or scene you wish to remove and set its State to "Removed".

After this is complete, you will see that the avatar has been grey-ed out and that it is no longer accessible by its avatar url.

Deleting assets in spoke


Accounts and Identities

The Accounts tab of the Admin Panel indexes all users who have signed-in to your hub with an email address. For privacy reasons, all emails are hashed to protect user data, however it is possible to search for specific email addresses to verify individual user accounts. When you edit a user's account, you have the option to make them an admin in order for them to have access to the Admin Panel. Making a user an Admin will NOT let them manage your Hubs Subscription. PLEASE NOTE: You should never remove the account using the email associated with your Hubs account!!!

Deleting assets in spoke

Adding Admin Accounts

If the account you wish to promote has not yet been created, use the create account form to create a new account with the user's email.

Creating accounts by email

If the account you wish to promote has already been created, use thefind account feature to search for the account of an individual email.

Searching accounts by email

  1. Select the edit button next to the account you wish to promote.

  2. In the pop-up, enable "is-admin" and save your settings.

Screenshot of the Scene Browser Your browser does not support HTML5 video.

Identities

Identities is a deprecated method for associating an account with a username. This feature is functional, but should not be utilized.


Projects

The Projects tab allows you to moderate any Spoke projects that have been created on your server. When you expand the details of an individual project, you are also able to download a version of their .spoke file. You can also select the check-box next to a project and manually delete it. Please note that this will not delete any asset data included in the project, just the project information itself.

Deleting assets in spoke


Logos and Brand Themeing

Depending on your subscription plan, your hub will allow you to customize the user interface's (UI) colors and logos. Under the "Setup" category in the Admin Panel, you can use the "Brand" tab to upload custom images. Supported file types are listed next to each logo type.

Deleting assets in spoke

In the "Themes" tab, you are able to upload your own JSON theme-ing object to fully customize the UI colors of your hub. For more information on updating your hub's theme, check out this guide.

Deleting assets in spoke


App Settings

App Settings allow you to control the default behavior, settings, and permissions of your hub and its user interface.

Translations (site identification)

SettingDescription
App NameThe site name visible in the browser tab, on the magic link email, and room sharing preview
App DescriptionThe description above the "Create Room" button on the homepage
App TaglineThe tagline underneath the company logo on scene urls
Company NameThe name included in Spoke and the in-app avatar creation tool when allowing the app owner to promote an asset
Share HashtagHashtag included when sharing a photo, video or scene
Contact EmailThe email listed on the static page displayed when a room owner closes the room
Community PromptThis feature is deprecated and should not be utilized.

Features

SettingDescription
Account CreationThis feature prevents unpromoted users from creating accounts. This will prevent them from signing-in to Spoke and associating their email with any created rooms.
Terms of UseDisplays the link to the Terms of Use across the app. This includes the homepage, the Support section of the in-world settings panel, and the page displayed when a room is closed by a room owner.
Privacy NoticeDisplays the link to the Privacy Notice on the homepage and under the Support section of the in-world settings panel.
Controls LinksDisplays the link to Controls under the Support section of the in-world settings panel with a life-perserver logo. Is often the Controls page on this site
Docs LinksDisplays the link to Docs under the Support section of the in-world settings panel with a life-perserver logo and the name "Help". Is often the root of this site
Features LinksThis feature is not currently functional.
Community LinksDisplays the link to Community on the homepage and under the Support section of the in-world app with the Discord Logo.
Company LogoDisplays the Company Logo uploaded under the Brand tab on the homepage, loading screen, and in-world.
Issue Report LinkDisplays the link to Issue Report under the search bar on the in-app scene/avatar browser and under the Support section of the in-world app with the 'i' logo.
Avatar Pipelines LinkDisplays the link to the Hubs' avatar pipeline documentation in the in-app avatar creation tool.
Model Collection LinkDisplays the link to Model Collection when a user attempts to upload a custom asset url in-world .
Powered By HubsDisplays the "Powered By Hubs" tag on the homepage and loading screens.
Public RoomsAllows non-administrators to set rooms to be public, featuring them on the homepage.
Homepage Room IDReplaces the homepage with a individual room.
Scene EditorAllows all users to create Spoke projects. This feature will not operate when account creation is disabled. This feature is an important method of managing data usage.
Lobby GhostsAllows users who choose "Spectate" when entering room to move throughout the space as an invisible listener.
Public API AccessAllows admins to create API tokens and submit requests to the Hubs API.

Rooms

SettingDescription
Permissive RoomsEnables/disables all room member settings when a new room is created.
Room CreationAllows non-administrators to create rooms. This can be an important feature to limit data buildup on your server.
Accounts for Room AccessRequires new users to sign-in before joining any room url.
Default Room SizeThe default room size of newly created room urls.
Maximum Room SizeThe maximum room size allowed across your application. This feature is an important tool to manage your server's CCU limit.

Links

These URLs correspond to the links enabled in the "Features" tab of App Settings.

Auth

SettingDescription
Magic Link Email SubjectThe subject line of magic link emails sent to users signing-in.
Custom MessageCustomize the body of magic link emails sent to users signing-in.
← How to back up your Hubs instanceFrequently Asked Questions →
  • Introduction
  • Default Content
  • Importing and Migrating Content
  • Managing Scenes and Avatars
  • Managing Content Storage
  • Accounts and Identities
  • Projects
  • Logos and Brand Themeing
  • App Settings
Hubs
Docs
IntroductionSetting Up Your HubHubs FundamentalsSpoke DocumentationFor CreatorsFor DevelopersAdministration
Community
Discord Chat
More
HubsSpokeGitHub
Copyright © 2024–2025 Hubs Foundation. Hubs Documentation available under the Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) license.