The five rules
Tesla publishes its wrap templates and the file rules in the official custom-wraps repository. All five apply at once — passing four is the same as passing none.
- A real PNG file, not a renamed JPEG.
- At most 1 MB.
- Each side between 512 and 1024 px.
- File name of 30 characters or fewer, using letters, numbers, spaces, underscores or dashes.
- A template size that matches your exact model and trim.
What each failure looks like
The symptom tells you which rule you broke, if you know where to look.
| Symptom | Usual cause | Fix |
|---|---|---|
| Wrap never appears in the list | Not a real PNG, or over 1 MB | Re-export as PNG; compress below 1 MB |
| Wrap appears but is blank or partly black | Wrong template size, or transparency where paint should be | Re-export at 1024×1024 (1024×768 for Cybertruck) |
| Lines jump at the doors or hood edge | Design drawn on another model or trim | Start again on the correct template |
| Upload fails before it starts | File name longer than 30 characters or containing symbols | Rename to letters, numbers, spaces, _ or - |
| App upload works, USB does not | PNG not in a root folder named Wraps | Move the file into /Wraps on the drive |
Why the 1 MB limit bites
A 1024×1024 PNG with photographic texture easily passes 1 MB. The fix is not to shrink the canvas — that breaks the template — but to simplify the image: fewer gradients, flatter color fields, and re-encoding until the file fits. The checker on this site does that loop for you and tells you the final size.
Check before you upload
Run the exported file through the PNG checker: it verifies the signature, size, dimensions and name in the browser, fixes the name and dimensions, and shows the result on a 3D car so you can see seam errors that the file rules cannot catch.