Articles in this section

Compatibility

    To display 3D content in real-time, Sketchfab relies on WebGL, which is a standard rendering library in most modern browsers. You can check if your browser is compatible on https://get.webgl.org/

    For more technical details about WebGL on your machine, visit WebGL Report.

    Desktop

    Sketchfab is compatible with all modern browsers, including:

    • Mozilla Firefox
    • Google Chrome
    • Opera
    • Safari
    • Edge
    • Any other Chromium-based browser
    Sketchfab is not supported in Internet Explorer.
    In Safari 7.1.3 (OS X 10.9) and earlier, WebGL must be enabled manually.
    Go to Safari → Preferences → Advanced and check Show Develop menu in menu bar. Go to Develop → Enable WebGL.

    Mobile

    • iOS 8+
    • Android 4.0+

    Troubleshooting

    WebGL

    On older browsers or devices with WebGL disabled, models are displayed with an image-based fallback that gives a 360° turntable view of the model.

    If you run into problems, make sure your graphics driver and browser are up-to-date. If that doesn’t help, try one of the other browsers listed above. https://get.webgl.org/ is a good place to start troubleshooting.

    Sometimes, your browser may disable WebGL based on your GPU. If you are using a compatible browser, but you see an incompatible warning or the viewer performs very badly, try forcing the browser to use your GPU:

    Chrome

    If you go to WebGL Report and see "SwiftShader" listed as the renderer, the steps above should solve the problem.

    Firefox

    Type about:config into the address bar and enable webgl.force-enabled.

    Touch Screens / Tablets

    Sometimes, navigating a model may not work on a touch screen or tablet device. This is especially common on certain Windows 10 devices. In Chrome, for example, visit chrome://flags/#touch-events and enable the "Touch Events API" flag.

    Scripts and Cookies

    In order to load correctly, the viewer needs to run various JavaScript scripts. It also needs access to browser cookies for various purposes such as respecting Sound volume and Restricted Content settings. If script execution or cookies are blocked by browser settings, plugins, sandboxing the Sketchfab iframe, or other methods, the viewer will not load. If you must sandbox the iframe for some reason, you must also lift several restrictions to make sure all viewer features work as expected:

    • allow-scripts (needed to load the frame whatsoever)
    • allow-same-origin (needed to allow the frame to communicate with our servers)
    • allow-popups (needed for links within the frame to work)
    • allow-forms (needed if the model is password-protected so that you can enter the password)

    You will want your iframe HTML code to look something like this (note the sandbox attribute).

    <iframe sandbox="allow-scripts allow-same-origin allow-popups allow-forms" frameborder="0" width="xxx" height="xxx" src="https://sketchfab.com/models/xxxxxxxx/embed"></iframe>

    You can also remove the sandbox attribute completely if possible.

    <iframe frameborder="0" width="xxx" height="xxx" src="https://sketchfab.com/models/xxxxxxxx/embed"></iframe>
    If script execution is blocked, you may see an error message in the Sketchfab viewer explaining, "it looks like you're blocking some scripts or cookies necessary to properly display the viewer".

    WordPress Users

    Sketchfab must be added as 'Trusted oEmbed Provider', otherwise WordPress will automatically add sandbox restrictions to Sketchfab iframes.

    Adding the following line to a plugin or functions.php in the theme directory solves that:

    wp_oembed_add_provider( '#https?://sketchfab\.com/.*#i', 'https://www.sketchfab.com/oembed', true );

    It is also added by the JetPack plugin and the Sketchfab oEmbed plugin.

    Avatar
    James
    • Updated
    Follow

    Related articles

    Comments

    156 comments

    Sort by Date Votes

    Please sign in to leave a comment.