Create and Upload Custom Assets

Keep reading to learn about:

Custom Assets

Uploading Custom Assets

Asset Boundaries

Best Practices

What is an Asset?

Assets are the building blocks of your scene or world and are crucial to the look and feel of the space you want to create. Every image you see in a scene is an asset. They can be simple like a rectangular platform or artistic like a weeping willow tree. The SchoolSpace Asset Library contains an extensive assortment of assets available for you to use but you can also upload your own custom assets!

Use custom assets to add:

• Your school logo.
• Your school mascot.
• Lesson specific assets.
• Anything you need for your world that isn't available in the SchoolSpace Asset Library.

Uploading Custom Assets

Before uploading a custom asset, you will need an image file (.png, .WebP, or .jpeg). Tips for creating these files can be found below. To upload a custom asset, you'll need to be an Editor, Designer, Manager, or world Owner.

To Upload a Custom Asset: 

1. Click Builder Mode in the left sidebar or press B on your keyboard to enter Builder Mode.
2. Click Assets in the left sidebar.
3. The Asset Library will open in a thumbnail list view on the left side of your screen. Click the purple Plus button.
   
   

    

4. Give your asset a name (max 40 characters). Tip: Use something descriptive so you’ll recognize it later.
   
   

    

5. If your asset has multiple “layers” (e.g., a graphic on top of a background) you may choose to upload your file as a top layer or bottom layer. You can include a top and a bottom layer in the same asset (e.g., a fountain pool as a bottom layer and the fountain spout as a top layer).
   • Top layer means it appears in front of avatars or objects.
   • Bottom layer means it appears behind them (e.g., a path or floor graphic the avatars walk on).
6. Click Choose File to upload your top layer and/or your bottom layer files.
   • Accepted file types: PNG, WEBP, and JPEG up to 2048px x 2048px.

    

7. Upload your asset by clicking:
   • Upload Asset to upload and save for later use.
   • Upload and Place Asset if you want to place it immediately in your world. Tip: We recommend using Upload and Place Asset so you can test if your asset appears as expected in the world.

    

8. Once uploaded, the asset will be added to your My Assets accessed in the Asset Library in the left sidebar. You can place the asset in your world, position it, resize it, and adjust any configurations as needed. 

Best Practices

• Choose descriptive names: Use names like “SchoolLogo_MainHall” or “VirtualStage_Backdrop” so you can easily find the asset later.
• Check image dimensions: Make sure your image file is less than 2048px x 2048px.
• Use transparent backgrounds when needed: If your image has areas you want to appear invisible (for example a logo that floats over another graphic), use PNG format with transparency.
• Consider layering wisely: If you want the asset to appear behind an avatar (e.g., a path), make sure you use a bottom layer. If you want the asset to appear in front of the avatar (e.g., a wall), use a top layer. 
• Check for visual clarity: Use Upload and Place to test the asset in your world. Make sure it looks clean, sharp, and sized appropriately relative to avatars or other objects. You can increase or decrease the size of the asset in the world if needed.
• Test in actual use: If your asset is intended to be clickable, attach a link and test how clicking feels. Assets that are very small can be difficult to click while assets that are extra large can impede navigation.
• Organize your asset library: Over time you’ll accumulate many assets. Create naming conventions to keep things tidy.
• Version control: If you update an image (e.g., new school branding), consider renaming with a date or version (like “SchoolLogo_2025v2”) so you keep track of changes.

Asset Boundaries

In SchoolSpace you may want some assets to be clickable (e.g., a poster that when clicked opens a link). When you upload custom assets and make them interactive, it’s important to be aware of asset boundaries (the invisible “box” around your image) and how that affects user interaction. 

What are asset boundaries?

• When you upload an image, SchoolSpace treats it as a rectangular object (even if the visible part is a circle or has transparent edges). The system sets a bounding box around the full image file.
• If your image has large transparent margins (empty space) around it, the clickable area may include those margins - meaning you (or a student) may click where you visually expect nothing and still open the link.

Best practice for clickable assets

• Before uploading, crop the image to remove unnecessary transparent space so the asset boundaries align closely with the visible part.
• After placing the asset in your world, attach a link and test it by clicking around the edges. Watch for when your cursor changes to a pointer finger and make sure the behavior matches your expectations. 
• If the asset is meant to be behind avatars or other objects but still clickable, make sure its layer and spacing are set correctly so users can still reach it without being blocked or clicking something else by accident.
• Consider movement flow through the world and avoid placing clickable assets in an area where people will click to walk.
• Label or name clickable assets clearly (“Banner_LinkToResources”, “InfoPanel_Clickable”) so you and your team know which assets trigger actions.