LogoLogo
WebsiteBlogForumsSign up
  • Welcome
  • How Ready Player Me works
  • FAQ
  • 👩‍💻Integration Guides
    • Overview
    • Unity
      • Quickstart
      • Avatar Creator Integration
        • WebView Avatar Creator
          • Avatar Creator for Android & iOS
          • Avatar Creator for WebGL
        • Build your own Avatar Creator
          • Start with the sample
          • Elements
            • Asset Selection Element
            • Color Selection Element
            • Template Selection Element
            • Body Shapes Selection Element
            • Gender Selection Element
            • Avatar List Element
            • Photo Capture Element
            • Signup Element
            • Login Element
            • Logout Element
          • User Management
      • Load 2D Renders
      • Avatar Loader Window
      • Setup Multiplayer
      • Setup for XR (Beta)
        • Setup the Player Avatar
        • Setup Meta Movement SDK
        • Setup Final IK
        • Setup XR Hands
          • RpmHandDriver script
        • Facial Animations
        • VR Avatar Creator
      • Animations
        • Ready Player Me Animation Library
        • Mixamo Animations
      • Optimize
        • Avatar Configuration
        • Avatar Caching
        • Defer Agents
      • Code Samples
        • Loading 3D Avatars
        • Loading 2D Avatars
        • Avatar Creator (WebGL)
        • Avatar Creator (Desktop)
        • Avatar Creator (Mobile)
        • Distance-based LODs
      • Troubleshooting
        • Editor UI Window Issues
        • Avatar loading issues
        • iOS issues
        • WebGL issues
        • Firewall issues
        • Updating the SDK
          • Unity SDK 3.0.0 Migration guide
          • Unity SDK 4.0.0 Migration guide
          • Unity SDK 5.0.0
          • Unity SDK 7.0.0
          • WebView 2.0 Migration
        • Package installation issues
      • Help us improve the Unity SDK
      • FAQ for Unity
      • Early Access Features
    • Unreal Engine
      • Quickstart
        • Import SDK Manually
      • Avatar Creator Integration
        • Build your own Avatar Creator
          • Sample Structure
          • Customization Guide
        • WebView Avatar Creator
      • Load Avatars
      • Animations
        • Ready Player Me Animation Library
        • Loading Mixamo animations
        • Mannequin animation retargeting
        • Blender FBX export to UE
        • Oculus Lipsync integration
      • Optimize
        • Avatar configuration
        • Avatar caching
        • Avatar preloading
      • Code Samples
        • Unreal Engine 5 samples
        • Lyra project integration example
        • VR Avatars
        • Unreal Engine 4
      • Troubleshooting
        • Project compilation issues
        • Missing materials on built applications
        • Avatar loading issues
        • Animation issues
        • Unreal SDK breaking changes
        • Avatar lighting issues
        • Updating from earlier versions
          • Unreal SDK 3.0.0 Migration guide
        • Auto LOD issues
      • Help us improve the Unreal Engine SDK
      • FAQ for Unreal Engine
      • Early Access Features
    • React
      • Quickstart
    • React Native
    • iOS Native
    • Android Native
    • Web Integration
      • Quickstart
      • User Management
        • Guest Accounts
        • Account Linking
      • Avatar Creator integration
      • Optimize
    • API Integration
      • Quickstart
      • Custom Avatar Creator
      • User management
        • Ready Player Me Account
        • Anonymous Accounts
    • UX/UI Guidelines
      • Summary & quick tips
      • UX and UI guidelines and essentials
        • Foundation for good user experience
          • Layout
          • Colors
          • Typography
          • Icons
          • Dark mode and light mode
        • Mobile best practices
          • Layout
        • Making Ready Player Me feel native
          • Seamless Avatar Integration
          • Consistent Branding
          • Responsive Layout
          • Performance Optimization
        • Discoverability of the avatar editor
          • Onboarding tutorial
          • Clear navigation
          • Contextual Placement
  • 🖌️Customizing Guides
    • Studio (Developer Dashboard)
    • Avatar Creator Appearance
      • Avatar URLs
      • Avatar Shortcodes
    • Upload and Manage Custom Assets
      • Asset Manager in Studio
      • Configure in Studio
      • Manage custom assets using the API
      • Unlocking assets through API (Beta)
    • Create Custom Assets
      • Fullbody Outfits
        • Checking Skin Weights
      • Tops, Bottoms, Shoes
        • Editing templates
      • Hairstyle
      • Headwear
      • Facewear
      • Glasses
      • Hero Characters
      • Modeling Guidelines
  • 🔃API Reference
    • REST API
      • Authentication
      • Avatars
        • GET - 3D avatar
        • GET - 2D Render of an Avatar
        • GET - Metadata
        • PUT - Equip an asset
        • PUT - Unequip an asset
      • Assets
        • Asset Entity Properties
        • POST - Create Asset
        • GET - List Assets
        • PATCH - Update Asset
        • POST - Upload Asset Files
        • POST - Add Asset to Application
        • DELETE - Remove Asset from Application
        • PUT - Unlock asset for a user
        • PUT - Lock asset for a user
      • Users
        • POST - Create User
      • Auth
        • GET - Token
      • Changelog
    • Avatars
      • Full-body avatars
      • Full-body XR avatars
      • Half-body avatars
      • Morph targets
        • Apple ARKit
        • Oculus OVR LipSync
    • Avatar Creator
  • 🔉Support
    • Forums
    • Licensing & Privacy
Powered by GitBook
On this page
  • Benefits
  • Features
  • Steps for uploading and managing custom assets
  • Managing custom assets
  • Error handling

Was this helpful?

  1. Customizing Guides
  2. Upload and Manage Custom Assets

Asset Manager in Studio

Upload custom outfits in Studio and make them available in your apps.

PreviousUpload and Manage Custom AssetsNextConfigure in Studio

Last updated 1 year ago

Was this helpful?

Asset Manager in Ready Player Me Studio allows Ready Player Me partners to upload, validate, publish, and manage custom assets for avatars within the Studio dashboard in a self-serve manner.

Note: Uploaded assets will only be available in your applications.

Asset Manager is currently in the Open Beta stage. During this time, you might experience unexpected bugs. In such cases, please submit your feedback here:

Benefits

  • Personalize the user experience by uploading custom assets.

  • Validate custom assets automatically upon upload.

  • Enable or disable custom assets in your applications.

  • Can be used by anyone on the team. No coding skills required.

Features

  • Model type

    • There are several different asset types that you can upload. Select the one you want to upload. Learn more about them in Create Custom Assets.

  • Model upload

    • Only GLB (.glb) files are accepted.

    • File size: up to 10MB.

  • Validation

    • Upon upload, your model is automatically validated to check the asset for errors.

  • Model preview

    • Display of the uploaded model.

  • Gender

    • Choose whether the uploaded asset is for masculine, feminine, or all (Neutral) avatar models. If you want to make the same asset available for both gender stereotypes, you need select Neutral. If Neutral is not available for a certain asset type, you'd need to upload a separate version for each gender stereotype.

  • Preview icon

    • Upload an icon of your asset that will be displayed in the asset list of the avatar editor.

    • Max icon dimensions: 256x256 pixels.

    • You can use PNG files with transparency.

    • File size: up to 5MB. We recommend a small icon (< 1MB) to improve UI download speed for users.

  • Assign to application

    • To make an asset available to users, assign it to one or more of your applications.

    • If you do not assign the asset to an application, you can save it, but it will not be available to your users.

  • Edit uploaded assets

    • Saved custom assets can be edited by removing the current model or icon and uploading a different one.

    • Important: Editing existing assets will immediately affect users that use them. For example, if a user has your custom asset equipped, it will be changed once you edit it.

  • Asset Manager overview

    • List of your uploaded assets. You can sort by status, gender, and last updated.

    • Search assets by name.

    • Filter by gender and app.

    • Active (checkmark) means the asset is available in one of your apps. Inactive (x) means the asset is saved but not assigned to an application.

  • Deleting assets

    • You can delete assets after they have been unassigned from the application to fully remove them from Asset Manager.

Steps for uploading and managing custom assets

  1. In the side navigation, click Asset Manager.

  2. Click Add new asset.

  3. Fill in the information on the Add new asset screen, as described below.

  • Asset name: Name of the asset.

  • Gender: If your asset only fits the masculine or feminine templates, you need to select "Male" or "Female" respectively. If it fits both models, you need to select "Neutral" if available, otherwise you need to create an asset for each gender stereotype.

  • Model: Upload a .glb file (< 10MB) of the custom assets.

  • Preview icon: Upload a square-shaped icon (< 5MB, 256x256 max) that will be displayed as a preview of your assets in the avatar editor, as shown below.

  • Applications: List of your applications. Check an application to make your asset available to users of this application.

    • If you don't select an application, the asset is saved, but it won't be available to users.

  • Add or Save button: The new or edited asset is validated and saved.

    • If validation is successful, you receive a “Validation successful” notification and the uploaded model preview is displayed.

Once you have saved your new asset, you are returned to the Asset Manager page.

Managing custom assets

The Asset Manager page lists your custom assets.

  • Name and preview icon identify your asset.

  • Active: Indicates whether the asset is assigned to an application. Active (checkmark) means the asset is available in one of your apps. Inactive (x) means the asset is saved but not assigned to an application.

  • Gender: Asset fits male, female, or both ("neutral") models.

  • Type: Type of the asset.

  • Last updated: Date and time of the last changes.

To edit an asset, click its name.

Note: If you replace the model, it will go through validation again before you can save the asset.

Error handling

If asset validation fails, you receive a notification, and a pink outline marks the asset preview.

  1. Below the asset preview (you may need to scroll), look for the Validation log button.

  2. Click Validation log to see a summarized list of actionable items based on the errors.

  3. Click Expand full .json log to see a JSON file of your errors in detail.

  4. Click Copy log to copy the file contents to your clipboard.

  5. Paste the contents into a text file and save it for further use.

Go to and login.

If validation fails, you receive a notification, and a pink outline marks the asset preview. Below the asset preview (you may need to scroll), click Validation log to open a JSON file of your errors. See for details.

🖌️
Ready Player Me Studio
Error handling
https://support.readyplayer.me/kb-tickets/new