All Products
Search

This Product

    Object Storage Service:Configure the Content-Type header

    Document Center

    Object Storage Service:Configure the Content-Type header

    Last Updated:Mar 20, 2026

    When browsers and HTTP clients receive an object from OSS, they rely on the Content-Type header to decide how to handle it — whether to render a web page, display an image, stream a video, or prompt a file download. Setting Content-Type correctly prevents clients from mishandling your objects (for example, serving an HTML file as a binary download or treating an image as plain text).

    How OSS determines Content-Type

    OSS applies the following logic at upload time:

    1. If you explicitly set Content-Type in the upload request, OSS uses that value.

    2. If you do not set it, OSS SDKs infer the value from the object name extension. For example, an object named photo.jpg gets image/jpeg.

    3. If the object name has no extension, OSS defaults to application/octet-stream (binary stream).

    Set the Content-Type header

    Set or update Content-Type for an object using any of the following tools: OSS console, ossbrowser, OSS SDKs, ossutil, or OSS API. For step-by-step instructions, see Manage object metadata.

    Important

    You can set Content-Type only for one object at a time. Bulk updates by object name prefix or extension are not supported.

    Common Content-Type values

    Use the following table as a reference when setting Content-Type manually.

    ExtensionContent-Type (MIME type)ExtensionContent-Type (MIME type)
    (binary stream or unknown object type)application/octet-stream.tifimage/tiff
    .a11application/x-a11.acpaudio/x-mei-aac
    .aiapplication/postscript.aifaudio/aiff
    .aifcaudio/aiff.aiffaudio/aiff
    .anvapplication/x-anv.apkapplication/vnd.android.package-archive
    .asatext/asa.asfvideo/x-ms-asf
    .asptext/asp.asxvideo/x-ms-asf
    .auaudio/basic.avivideo/avi
    .awfapplication/vnd.adobe.workflow.biztext/xml
    .bmpimage/bmp.botapplication/x-bot
    .c4tapplication/x-c4t.c90application/x-c90
    .calapplication/x-cals.catapplication/vnd.ms-pki.seccat
    .cdfapplication/x-netcdf.cdrapplication/x-cdr
    .celapplication/x-cel.cerapplication/x-x509-ca-cert
    .cg4application/x-g4.cgmapplication/x-cgm
    .citapplication/x-cit.classjava/
    .cmltext/xml.cmpapplication/x-cmp
    .cmxapplication/x-cmx.cotapplication/x-cot
    .crlapplication/pkix-crl.crtapplication/x-x509-ca-cert
    .csiapplication/x-csi.csstext/css
    .csvtext/csv.cutapplication/x-cut
    .dbfapplication/x-dbf.dbmapplication/x-dbm
    .dbxapplication/x-dbx.dcdtext/xml
    .dcxapplication/x-dcx.derapplication/x-x509-ca-cert
    .dgnapplication/x-dgn.dibapplication/x-dib
    .dllapplication/x-msdownload.docapplication/msword
    .docxapplication/vnd.openxmlformats-officedocument.wordprocessingml.document.dotapplication/msword
    .dotxapplication/vnd.openxmlformats-officedocument.wordprocessingml.template.drwapplication/x-drw
    .dtdtext/xml.dwfModel/vnd.dwf
    .dwfapplication/x-dwf.dwgapplication/x-dwg
    .dxbapplication/x-dxb.dxfapplication/x-dxf
    .ednapplication/vnd.adobe.edn.emfapplication/x-emf
    .emlmessage/rfc822.enttext/xml
    .epiapplication/x-epi.epsapplication/x-ps
    .epsapplication/postscript.etdapplication/x-ebx
    .exeapplication/x-msdownload.faximage/fax
    .fdfapplication/vnd.fdf.fifapplication/fractals
    .fotext/xml.frmapplication/x-frm
    .g4application/x-g4.gbrapplication/x-gbr
    .application/x-.gifimage/gif
    .gl2application/x-gl2.gp4application/x-gp4
    .hglapplication/x-hgl.hmrapplication/x-hmr
    .hpgapplication/x-hpgl.hplapplication/x-hpl
    .hqxapplication/mac-binhex40.hrfapplication/x-hrf
    .htaapplication/hta.htctext/x-component
    .htmtext/html.htmltext/html
    .htttext/webviewhtml.htxtext/html
    .icbapplication/x-icb.icoimage/x-icon
    .icoapplication/x-ico.iffapplication/x-iff
    .ig4application/x-g4.igsapplication/x-igs
    .iiiapplication/x-iphone.imgapplication/x-img
    .insapplication/x-internet-signup.ipaapplication/vnd.iphone
    .ispapplication/x-internet-signup.IVFvideo/x-ivf
    .javajava/*.jfifimage/jpeg
    .jpeimage/jpeg.jpeapplication/x-jpe
    .jpegimage/jpeg.jpgimage/jpeg
    .jpgapplication/x-jpg.jsapplication/x-javascript
    .jsptext/html.la1audio/x-liquid-file
    .larapplication/x-laplayer-reg.latexapplication/x-latex
    .lavsaudio/x-liquid-secure.lbmapplication/x-lbm
    .lmsffaudio/x-la-lms.lsapplication/x-javascript
    .ltrapplication/x-ltr.m1vvideo/x-mpeg
    .m2vvideo/x-mpeg.m3uaudio/mpegurl
    .m4evideo/mpeg4.macapplication/x-mac
    .manapplication/x-troff-man.mathtext/xml
    .mdbapplication/msaccess.mdbapplication/x-mdb
    .mfpapplication/x-shockwave-flash.mhtmessage/rfc822
    .mhtmlmessage/rfc822.miapplication/x-mi
    .midaudio/mid.midiaudio/mid
    .milapplication/x-mil.mmltext/xml
    .mndaudio/x-musicnet-download.mnsaudio/x-musicnet-stream
    .mochaapplication/x-javascript.movvideo/quicktime
    .movievideo/x-sgi-moviemp1audio/mp1
    .mp2audio/mp2.mp2vvideo/mpeg
    .mp3audio/mpeg.mp4video/mp4
    .mpavideo/x-mpg.mpdapplication/vnd.ms-project
    .mpevideo/x-mpeg.mpegvideo/mpg
    .mpgvideo/mpg.mpgaaudio/rn-mpeg
    .mppapplication/vnd.ms-project.mpsvideo/x-mpeg
    .mptapplication/vnd.ms-project.mpvvideo/mpg
    .mpv2video/mpeg.mpwapplication/vnd.ms-project
    .mpxapplication/vnd.ms-project.mtxtext/xml
    .mxpapplication/x-mmxp.netimage/pnetvue
    .nrfapplication/x-nrf.nwsmessage/rfc822
    .odctext/x-ms-odc.outapplication/x-out
    .p10application/pkcs10.p12application/x-pkcs12
    .p7bapplication/x-pkcs7-certificates.p7capplication/pkcs7-mime
    .p7mapplication/pkcs7-mime.p7rapplication/x-pkcs7-certreqresp
    .p7sapplication/pkcs7-signature.pc5application/x-pc5
    .pciapplication/x-pci.pclapplication/x-pcl
    .pcxapplication/x-pcx.pdfapplication/pdf
    .pdbchemical/x-pdb.pdxapplication/vnd.adobe.pdx
    .pfxapplication/x-pkcs12.pglapplication/x-pgl
    .picapplication/x-pic.pkoapplication/vnd.ms-pki.pko
    .plapplication/x-perl.plgtext/html
    .plsaudio/scpls.pltapplication/x-plt
    .pngimage/png.pngapplication/x-png
    .potapplication/vnd.ms-powerpoint.potxapplication/vnd.openxmlformats-officedocument.presentationml.template
    .ppaapplication/vnd.ms-powerpoint.ppmapplication/x-ppm
    .ppsapplication/vnd.ms-powerpoint.ppsxapplication/vnd.openxmlformats-officedocument.presentationml.slideshow
    .pptapplication/vnd.ms-powerpoint.pptapplication/x-ppt
    .pptxapplication/vnd.openxmlformats-officedocument.presentationml.presentation.prapplication/x-pr
    .prfapplication/pics-rules.prnapplication/x-prn
    .prtapplication/x-prt.psapplication/x-ps
    .psapplication/postscript.ptnapplication/x-ptn
    .pwzapplication/vnd.ms-powerpoint.r3ttext/vnd.rn-realtext3d
    .raaudio/vnd.rn-realaudio.ramaudio/x-pn-realaudio
    .rasapplication/x-ras.ratapplication/rat-file
    .rdftext/xml.recapplication/vnd.rn-recording
    .redapplication/x-red.rgbapplication/x-rgb
    .rjsapplication/vnd.rn-realsystem-rjs.rjtapplication/vnd.rn-realsystem-rjt
    .rlcapplication/x-rlc.rleapplication/x-rle
    .rmapplication/vnd.rn-realmedia.rmfapplication/vnd.adobe.rmf
    .rmiaudio/mid.rmjapplication/vnd.rn-realsystem-rmj
    .rmmaudio/x-pn-realaudio.rmpapplication/vnd.rn-rn_music_package
    .rmsapplication/vnd.rn-realmedia-secure.rmvbapplication/vnd.rn-realmedia-vbr
    .rmxapplication/vnd.rn-realsystem-rmx.rnxapplication/vnd.rn-realplayer
    .rpimage/vnd.rn-realpix.rpmaudio/x-pn-realaudio-plugin
    .rsmlapplication/vnd.rn-rsml.rttext/vnd.rn-realtext
    .rtfapplication/msword.rtfapplication/x-rtf
    .rvvideo/vnd.rn-realvideo.samapplication/x-sam
    .satapplication/x-sat.sdpapplication/sdp
    .sdwapplication/x-sdw.sisapplication/vnd.symbian.install
    .sisxapplication/vnd.symbian.install.sitapplication/x-stuffit
    .slbapplication/x-slb.sldapplication/x-sld
    .sldxapplication/vnd.openxmlformats-officedocument.presentationml.slide.slkdrawing/x-slk
    .smiapplication/smil.smilapplication/smil
    .smkapplication/x-smk.sndaudio/basic
    .soltext/plain.sortext/plain
    .spcapplication/x-pkcs7-certificates.splapplication/futuresplash
    .spptext/xml.ssmapplication/streamingmedia
    .sstapplication/vnd.ms-pki.certstore.stlapplication/vnd.ms-pki.stl
    .stmtext/html.styapplication/x-sty
    .svgimage/svg+xml.swfapplication/x-shockwave-flash
    .tdfapplication/x-tdf.tg4application/x-tg4
    .tgaapplication/x-tga.tifimage/tiff
    .tifapplication/x-tif.tiffimage/tiff
    .tldtext/xml.topdrawing/x-top
    .torrentapplication/x-bittorrent.tsdtext/xml
    .txttext/plain.uinapplication/x-icq
    .ulstext/iuls.vcftext/x-vcard
    .vdaapplication/x-vda.vdxapplication/vnd.visio
    .vmltext/xml.vpgapplication/x-vpeg005
    .vsdapplication/vnd.visio.vsdapplication/x-vsd
    .vssapplication/vnd.visio.vstapplication/vnd.visio
    .vstapplication/x-vst.vswapplication/vnd.visio
    .vsxapplication/vnd.visio.vtxapplication/vnd.visio
    .vxmltext/xml.wavaudio/wav
    .waxaudio/x-ms-wax.wb1application/x-wb1
    .wb2application/x-wb2.wb3application/x-wb3
    .wbmpimage/vnd.wap.wbmp.wizapplication/msword
    .wk3application/x-wk3.wk4application/x-wk4
    .wkqapplication/x-wkq.wksapplication/x-wks
    .wmvideo/x-ms-wm.wmaaudio/x-ms-wma
    .wmdapplication/x-ms-wmd.wmfapplication/x-wmf
    .wmltext/vnd.wap.wml.wmvvideo/x-ms-wmv
    .wmxvideo/x-ms-wmx.wmzapplication/x-ms-wmz
    .wp6application/x-wp6.wpdapplication/x-wpd
    .wpgapplication/x-wpg.wplapplication/vnd.ms-wpl
    .wq1application/x-wq1.wr1application/x-wr1
    .wriapplication/x-wri.wrkapplication/x-wrk
    .wsapplication/x-ws.ws2application/x-ws
    .wsctext/scriptlet.wsdltext/xml
    .wvxvideo/x-ms-wvx.xapapplication/x-silverlight-app
    .x_bapplication/x-x_b.xdpapplication/vnd.adobe.xdp
    .xdrtext/xml.xfdapplication/vnd.adobe.xfd
    .xfdfapplication/vnd.adobe.xfdf.xhtmltext/html
    .xlsapplication/vnd.ms-excel.xlsapplication/x-xls
    .xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheet.xltxapplication/vnd.openxmlformats-officedocument.spreadsheetml.template
    .xlwapplication/x-xlw.xmltext/xml
    .xplaudio/scpls.xqtext/xml
    .xqltext/xml.xquerytext/xml
    .xsdtext/xml.xsltext/xml
    .xslttext/xml.xwdapplication/x-xwd
    .x_tapplication/x-x_t.yamltext/vnd.yaml
    .ymltext/vnd.yml.webpimage/webp
    .tarapplication/x-tar.zipapplication/zip