This article covers a variety of common and complex causes regarding asset upload issues. Each section offers guidance and answers on ways to fix an issue.
Causes and issues covered include:
- Storage space
- File size
- File type
- Animations not uploading
- Blurry images
- Broken Images
- Over storage limit after unsubscribing
- Storage graph incorrect
- Continued incorrect storage quota
- Unable to set or change Roll20 Avatar / Campaign Image
If your storage quota is full, you will be unable to upload additional content or assets. You can check your current storage amount via https://app.roll20.net/account/
Storage Quota per Subscription Level
- Free : 100 MB of storage
- Plus : 3 GB of storage
- Pro : 8 GB of storage
If you are above the storage limit, you must first remove assets from your account in order to upload new assets. If you are a Free user, you can subscribe for additional storage space.
For information on how to delete assets and reclaim storage space see our help center article here: How to Clear Storage Quota
Ensure that the file you are attempting to upload is under the file size limits we maintain on Roll20. File size limits can differ based on subscription level as well as the type of file you are attempting to upload.
Upload Size Limits
- Image Files: 5 MB for Free users | 10 MB Plus & Pro users
- Audio Files: 20 MB
- PDF Files: 150 MB
If your file is above the limits you should make efforts to modify their file size. For image files, cropping or compressing the images can lower the overall size. If it is an audio file, you may wish to compress the bitrate or shorten the length. In the case of a PDF file, we recommend utilizing a PDF converter to make modifications. Adobe offers a free tool here.
Roll20 supports a wide variety of file types, but not all of them. Ensure that your file type matches those that we support for different formats. For more in-depth information on file types you can view our article here: Best Practices for Files on Roll20
Supported File Types
- Static Images: .jpeg | .jpg | .gif | .png
- Animated Images: .gif | .mp4 | .webm
- Audio: .mp3 | .oog | .flac | .wave
- Other: .pdf
If your file does not match one of the supported file types, we recommend converting them via a 3rd party program (paint, photoshop, etc.). Once they have been converted you can attempt to re-upload.
Animations not uploading
Animations can encounter issues even if none of the above situations apply. This is due to the fact that animations undergo a variety of conversions behind the scenes. Including changes to type and size (this does not impact your storage quota).
This conversion can be exacerbated if a file has undergone significant amounts of compression. So while a file size may be small, it can be complex. That complexity can slow the upload process.
If you are noticing slower than usual upload speeds on animations we recommend converting to a .webm format before uploading. Further, you may try shortening the animation length. If your file is compressed, we recommend attempting a different form of compression on the original file or simply shortening the overall length of the animation.
When an image is uploaded to Roll20 it undergoes a variety of conversions to create different sizes of the same image (This does not contribute to your storage quota). These are then utilized to conserve bandwidth and improve overall performance.
These issues can also arise in the event of attempting to utilize very high resolution images that will be small on the VTT. For example, using a 2000x2000 pixel avatar for a token that will only be shown at 70x70 pixels.
We recommend trying the following options:
- Clear your cache
- Try in incognito/private browsing
- Try in a separate browser
- Delete then re-upload the asset
- Re-upload the asset at a different resolution
If you are still experiencing issues, please contact us directly via the web form.
Broken images are commonly caused due to the assets being removed from the "Recent Uploads" section of the Art Library while within a game. The "Recent Uploads" section acts as a root or source file for all copies of that asset. If it is removed, then all copies of that image will seem to be broken.
Unfortunately, in the case of broken images, our customer support and dev team are unable to assist. We do not have the capability to recover lost or broken images at this time. We can only recommend re-uploading any missing assets.
Over storage limit after unsubscribing
When unsubscribing from Roll20, we do not delete or remove any assets on your account. As such, any assets you had prior to unsubscribing will contribute to your storage quota. This can result in going over your storage limit.
If you are above the storage limit after unsubscribing, you must first remove assets from your account in order to upload new assets. You may also re-subscribe for additional storage space.
Storage graph incorrect
After unsubscribing, the storage graph may show an incorrect readout showing that there is still storage space when there is not. This is a known issue with the graph by our development team.
You can verify the accuracy of your storage graph by checking the text read out just above. This provides a breakdown of assets on your account as well.
Continued incorrect storage quota
If you are still noticing a discrepancy in your storage quota via the text breakdown of your quota, please contact us directly via the web form.
Unable to set or change Roll20 avatar / campaign image
In the event that you are unable to set or change your Roll20 Avatar or Campaign image, this is commonly due to not having enough storage space (See Problem: Storage Space). Both avatars and campaign images also contribute to your Roll20 storage quota.
To resolve this, you will need to remove assets from your account to free up the storage space.
If you have sufficient storage space and are still unable to upload an avatar or campaign image, please contact us directly via the web form.