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
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
-
- Go to System Settings ( chrome://settings/ → Advanced → System ) and make sure Use hardware acceleration when available is enabled.
- Go to chrome://flags/#ignore-gpu-blacklist and enable the Override software rendering list flag.
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>
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.
Comments
170 comments
Please sign in to leave a comment.