Construct 3 icon

Construct 3

Documentation

MIME types

Published 23 Aug, 2017
524 words
~2-4 mins

When publishing to the web, it is important the server sends certain types of file with the correct MIME type. For example, most servers are correctly set up to send a .html file with the MIME type text/html. However some server's defaults don't include every MIME type your project might need to use. Also some servers may be configured to send the wrong MIME type, which may still cause some features to work incorrectly. The list below should be used as a reference of the correct MIME types to have set.

Configuring your server's MIME types depends on your host. If you don't know how to do this, contact your host for support, or ask them to set up the list below for you.

Having the wrong MIME type set can result in the file either returning "404 Not Found" (which can result in problems like audio not playing or AJAX requests failing), or cause the server to send a corrupt file (e.g. sending an audio file as a text file, causing it to fail to load).

If you are exporting a native app such as via Cordova or NW.js, there is no need to set up any MIME types.

MIME types for Construct 3 projects

A server hosting an exported Construct project should have these file extensions associated with these MIME types.

File ext. MIME type Notes
.html text/html Required
.js application/javascript Required
.json application/json Required
.css text/css Required
.wasm application/wasm Required (for WebAssembly)
.mem application/octet-stream Required (for asm.js)
.png image/png Required
.jpg, .jpeg image/jpeg Required
.webm video/webm Required, also covers WebM audio
.m4a audio/mp4 For AAC audio, if used
.mp3 audio/mpeg For MP3 audio, if used
.ogg audio/ogg For Ogg Vorbis audio, used in Construct 2 projects
.ogv video/ogv Optional, for Ogg Theora video
.mp4 video/mp4 Optional, for H.264 video
.woff application/font-woff For web fonts, if used
.woff2 font/woff2 For web fonts, if used
.txt text/plain Optional, for data files
.csv text/csv Optional, for data files
.xml text/xml Optional, for data files
.svg image/svg+xml Optional
.scml text/xml Optional, for Spriter animations
.scon application/json Optional, for Spriter animations
.c3p application/zip Optional, for Construct 3 project files

Offline caching

If you find there is a problem with your MIME types after exporting and then fix them, the problem may not appear to be immediately corrected if the browser has cached the previous server responses for offline support.

The easiest way to verify the problem is fixed after correcting a server's MIME types is to change the URL of the project, e.g. renaming the folder it was in on the server. This prevents the previous offline cache being used to load the game and it will start fresh with the new MIME type configuration taking effect.

More information

For more reading, see the Mozilla Developer Network (MDN) article on Configuring server MIME types.