Embeds are a great way to include media content from your app on your website. You can keep your media up-to-date and synced with just a click. However, embeds don’t always behave as expected. Here you’ll find some good troubleshooting information to help ensure your embed is pulled into your website properly!
General troubleshooting tips
If you’re finding that your embed doesn’t show up properly on your website, start by double-checking the embed code. Make sure you copy and paste directly from the Subsplash App Dashboard into your website. If you paste it into any other system, such as email, you risk encountering formatting errors.
Additionally, do not make any changes, subtractions, or additions to the code, as these are not supported and can break the whole embed experience.
A couple of notes worth mentioning at this time:
Multiple embeds on a single page will interfere with each other, we recommend having separate pages for each of your desired embeds.
Embeds will not work with Internet Explorer 11. IE11 is no longer supported by Microsoft (outside of security updates) and is not supported by the Embed system.
Troubleshooting for WordPress
When adding your embed code to your WordPress site, make sure you’re in the basic editor of the page and select the Text tab on the right-hand side of the editor. This allows for the addition of your iframe snippet.
If the embed doesn’t show up on your site right away, double-check that there is nothing in your theme that would conflict with the embed code.
Troubleshooting for Squarespace
Note! Squarespace has recently made a change preventing personal accounts from using custom JavaScript and iframe embeds. If you have any questions about this, please contact Squarespace support.
When adding your embed code to your Squarespace site, ensure the correct item type is added to your page. Squarespace has an Embed item, which sounds like it would be the one you want to use, however, this item uses Squarespace’s embed system to embed a full page into your site.
Instead, scroll down to the More section and add a Code item to your page.
You can then paste our provided embed code straight onto the page. This embeds just the media and search bar section of your Web App, allowing for your website header, menu, and footer to be used as normal.
Warning! Some Squarespace templates have a feature called Ajax loading. Unfortunately, this loading feature does not play well with 3rd party embeds and thus can cause trouble with Subsplash Web Embeds. You can read this Squarespace Help article for more information about this and instructions on turning off the Ajax feature.
Troubleshooting for other services
When adding your embed code to your site with other services (such as Wix and Weebly), make sure you surround your Web Embed with <body> tags.
Example:
<script id=”subsplash-embed-89zpmm7" type=”text/javascript”>var target = document.getElementById(“subsplash-embed-89zpmm7");var script = document.createElement(“script”);script.type = “text/javascript”;script.onload = function() {subsplashEmbed(“+txjq/lb/li/+89zpmm7?embed&branding”, “https://subsplash.com/”, “subsplash-embed-89zpmm7");};script.src = “https://dashboard.static.subsplash.com/production/web-client/external/embed-1.1.0.js”;target.parentElement.insertBefore(script, target);</script>
turns into:
<body><script id=”subsplash-embed-89zpmm7" type=”text/javascript”>var target = document.getElementById(“subsplash-embed-89zpmm7");var script = document.createElement(“script”);script.type = “text/javascript”;script.onload = function() {subsplashEmbed(“+txjq/lb/li/+89zpmm7?embed&branding”, “https://subsplash.com/”, “subsplash-embed-89zpmm7");};script.src = “https://dashboard.static.subsplash.com/production/web-client/external/embed-1.1.0.js”;target.parentElement.insertBefore(script, target);</script></body>
Warning! Formatting restrictions within Wix will prevent your Web Embed from using the fullscreen option.