• Documentation
• Building

Troubleshooting

• I'm getting a "Publish Failed" message when trying to publish my site
• I'm getting an "Unfinished Elements" message when trying to publish my site
• My changes aren't showing up on my published site
• My site gets stuck loading before it reaches 100%
• My site takes f-o-r-e-v-e-r to load in the builder
• The builder looks weird or broken when it loads
• The builder occasionally glitches out when I try using it on my phone
• I made some changes to my site but now the published version comes up blank
• I can't click on my Background or Page elements
• My site uses section breaks but the published version shows all of my sections at the same time
• My videos aren't autoplaying even though I checked "Autoplay"

• I'm getting a "Publish Failed" message when trying to publish my site

  This is a general error message indicating something about either the site or browser is preventing the builder from publishing. Some known causes for this:

  • You're using auto-fill to fill in the site's Title, Description, or URL (making the fields turn yellow). This has been known to interfere with publishing in at least in some browsers, so try filling these out by hand instead.

  • You're uploading SVGs saved directly from an app like Inkscape or Sketch. SVGs saved this way may end up in a format Carrd can't understand, so be sure to save them explicitly for use on the web. In Inkscape, for example, this can be accomplished by simply selecting "Optimized SVG" as the output format.

  • You're uploading animated GIFs generated by Ezgif. These are known to occasionally have issues with Carrd so if you're using GIFs generated by this service, try swapping them out with something else.

  • You're uploading images or videos that you've added to the site, but deleted locally. This might cause issues with larger images and videos so avoid deleting them until you've actually published the site.

  • You're uploading videos that have .MP4 file extensions, but aren't encoded in H.264. Carrd currently only accepts video uploads that have been encoded in H.264.

  • You're copying and pasting text from another app. While this usually works just fine, some apps will include hidden or invalid characters that Carrd will refuse to process. If you suspect this is the issue you're experiencing, try entering the text by hand or copying it to another app first (eg. a text editor) before copying it to the builder.

  • You were somehow logged out of your account, in which case simply open another tab to confirm that you're still logged in and, if you're not, log back in.

  ... but if none of these apply and you're still getting this message, please get in touch.

• I'm getting an "Unfinished Elements" message when trying to publish my site

  This usually means you have one or more elements waiting to be finished or assigned an image or video (for example, a Gallery element with unassigned images or a Container element expecting a background image). Clicking Go to element will jump to the first of these offending elements and outline the rest in red so you can identify and fix them. However, if you're not quite ready to do that, you can bypass this message by simply saving your site as an offline draft.

• My changes aren't showing up on my published site

  You're likely just seeing a locally cached (older) copy of the site, in which case simply doing a hard refresh on your published site (Ctrl + Shift + R on Windows, Cmd + Shift + R on macOS) or clearing your browser cache should bring up your changes.

• My site gets stuck loading before it reaches 100%

  Usually indicates there's an issue with one of your images. Get in touch and we'll get it sorted out.

• My site takes f-o-r-e-v-e-r to load in the builder

  If the site has many elements then this is probably the reason it's taking a while to load. Unfortunately this also means there isn't a "solution", but we're always optimizing the builder's performance so over time this should at least improve. That said, if the site doesn't have all that many elements and this is still happening, please get in touch.

• The builder looks weird or broken when it loads

  Usually happens when your browser has extensions installed that either change or block things on a page. To confirm whether or not this is the case, open the builder in a private or incognito window and see if it works. If it does, adding carrd.co to your extension whitelist(s) should permanently fix the issue. If it doesn't, test it in another browser and if it still doesn't work there, get in touch.

• The builder occasionally glitches out when I try using it on my phone

  The mobile builder is still somewhat beta-ish so while it'll work in a pinch, we recommend using the builder on desktop for the best experience. However, if you happen to be using Safari on iPhone, tapping the aA icon in the address bar then Hide Toolbar should greatly improve the experience on mobile.

• I made some changes to my site but now the published version comes up blank

  If you've added custom code by way of an Embed or an event, make sure the code is 100% valid Javascript as even a simple syntax error will break the site and prevent it from loading. You can usually confirm a code error is to blame by opening your browser console (Ctrl + Shift + J on Windows, Cmd + Shift + J on macOS) and reloading the site.

• I can't click on my Background or Page elements

  This might happen if you're using elements that cover up the entire background or page. In either case, you can always access either element by clicking Menu and clicking Background or Page.

• My site uses section breaks but the published version shows all of my sections at the same time

  This (along with Section View being unavailable) usually means there's a problem with your section break setup. A few common things to check:

  • You have a header marker after a section break, or you have more than one header marker. The elements that comprise your header must be placed before any other section, and each site can only have a single header defined.

  • You have a footer marker before a section break, or you have more than one footer marker. The elements that comprise your footer must be placed after any other section, and each site can only have a single footer defined.

• My videos aren't autoplaying even though I checked "Autoplay"

  Under certain conditions a browser may simply refuse to autoplay a video despite it being configured to do so. Some known reasons for this:

  • The video has an audio track. Muting the video should fix this, but if it still refuses to autoplay or the video is being used as the site background (in which case it's muted by default), try removing the video's audio track in its entirety.

  • The browser is on a device in low power, battery saving, or low bandwidth mode.

  • The browser has a blocker extension installed that explicitly blocks autoplaying media.