If the token image isn't displaying, there could be several possible reasons. Here are some common causes and solutions:
1. Incorrect Image Path or URL

If you're using a custom token image, ensure the path or URL is correct.
Check for typos or broken links (e.g., if hosted online, test the URL in a browser).
2. File Format or Size Issues
Supported formats:
.png,.jpg,.svg, or.webp.If the file is too large, try compressing it (e.g., using TinyPNG).
3. Permissions (For Online Hosting)
If the image is hosted online, ensure the server allows external access (no hotlink protection or CORS restrictions).
4. VTT or Game System Compatibility
Some virtual tabletop (VTT) platforms (like Foundry VTT or Roll20) may have specific requirements for token images.
Check if the image meets the system's guidelines (e.g., dimensions, transparency).
5. Cache Issues
Clear your browser or VTT cache and reload.
In Foundry VTT: Try holding
Shiftwhile reloading to force a hard refresh.
6. Token Configuration Error
Ensure the token is properly linked to an actor (if required).
Double-check the token settings (e.g., "Use actor image" vs. "Override image").
7. Module or System Conflict (For VTTs)
Disable modules/extensions one by one to check for conflicts.
Update your game system and modules to the latest versions.
8. Corrupted Image File
Try opening the image in another program to verify it’s not corrupted.
Re-export or re-upload the image.
Troubleshooting Steps:
Test the image in another application (e.g., browser or image viewer).
Try a different image to isolate the issue.
Check console errors (F12 in most browsers) for failed requests or CORS errors.
Consult documentation for your specific VTT/platform.
