[Internal]: Document supported file attachment types for Cases #5622
Description
Description
We do not currently document the supported file types for file attachments (e.g. in the Add files section), and I think this would be useful information to cover there.
It takes some testing to figure out what's allowed or not (by trying to attach different file types). We have an error message that lists out all of the supported types, but it's not the most readable. Ideally, this information should be available in the docs for reference if our users need it.
I'd like to propose a couple things:
- Add a list of supported file types
- Suggest a method for attaching non-supported types; e.g we don't currently support attaching Excel files (
.xlsx), but users can zip that into an archive and attach the archive file.
For reference, to help with the documentation, this is the full error message we show when a user tries to attach an unsupported file:
File mime type "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" is not supported. Supported mime types are: image/aces, image/apng, image/avci, image/avcs, image/avif, image/bmp, image/cgm, image/dicom-rle, image/dpx, image/emf, image/example, image/fits, image/g3fax, image/heic, image/heic-sequence, image/heif, image/heif-sequence, image/hej2k, image/hsj2, image/jls, image/jp2, image/jpeg, image/jph, image/jphc, image/jpm, image/jpx, image/jxr, image/jxrA, image/jxrS, image/jxs, image/jxsc, image/jxsi, image/jxss, image/ktx, image/ktx2, image/naplps, image/png, image/prs.btif, image/prs.pti, image/pwg-raster, image/svg+xml, image/t38, image/tiff, image/tiff-fx, image/vnd.adobe.photoshop, image/vnd.airzip.accelerator.azv, image/vnd.cns.inf2, image/vnd.dece.graphic, image/vnd.djvu, image/vnd.dwg, image/vnd.dxf, image/vnd.dvb.subtitle, image/vnd.fastbidsheet, image/vnd.fpx, image/vnd.fst, image/vnd.fujixerox.edmics-mmr, image/vnd.fujixerox.edmics-rlc, image/vnd.globalgraphics.pgb, image/vnd.microsoft.icon, image/vnd.mix, image/vnd.ms-modi, image/vnd.mozilla.apng, image/vnd.net-fpx, image/vnd.pco.b16, image/vnd.radiance, image/vnd.sealed.png, image/vnd.sealedmedia.softseal.gif, image/vnd.sealedmedia.softseal.jpg, image/vnd.svf, image/vnd.tencent.tap, image/vnd.valve.source.texture, image/vnd.wap.wbmp, image/vnd.xiff, image/vnd.zbrush.pcx, image/webp, image/wmf, text/plain, text/csv, text/json, application/json, application/zip, application/gzip, application/x-bzip, application/x-bzip2, application/x-7z-compressed, application/x-tar, application/pdf.
I asked Gemini to make that more readable to better understand what the supported file types are, and it categorized it like this:
Supported File Types
- Images: PNG, JPEG, GIF, WebP, SVG, TIFF, and specialized formats (HEIC, DICOM, DWG, DXF, PSD)
- Documents: PDF, Text, CSV, JSON
- Archives: ZIP, GZIP, BZIP/BZIP2, 7Z, TAR
Note: Before updating this, please confirm with a dev on the team that the list above is correct.
I have also opened up a dev issue to improve the error message we show in this scenario, but I would still like to document this.
Resources
See the description above.
Which documentation set does this change impact?
Elastic On-Prem and Cloud (all)
Feature differences
n/a
What release is this request related to?
N/A
Serverless release
n/a
Collaboration model
The documentation team
Point of contact.
Main contact: @melissaburpo
Stakeholders: @michaelolo24