Skip to main content
If you run into an error while publishing your project, find the specific error below for steps to resolve it.

​
Check Bolt’s status

Before troubleshooting, check the Bolt status page for any active incidents. If Bolt is experiencing a known issue, check your project again after the issue resolves to see if that also resolves your problem.

​
”Project is too large to deploy” error

To publish successfully, Bolt projects must be under 100MB. This is the combined size of your project files. If your project is larger than 100MB, you’ll see the following error when publishing: Project is too large to deploy. The maximum allowed size is 100MB.
Your overall project size is different from your project context window. If you see a message about your context being too large, see Manage project context.
Most commonly, projects hit this limit because they have large media files, like images or videos, stored directly in Bolt. To troubleshoot:
  1. Check how large your project is.
  2. Try deleting any images you aren’t using and check your project size again.
  3. If the project is still too large, move your media to an external storage service.
  4. Then, prompt Bolt to retrieve the images from the URL rather than from a file path in your project.
  5. Finally, delete the files from your project.

​
Check your project size

  1. Download your project.
  2. Find the project folder on your computer.
  3. Right-click the folder and view its information. This should include the project’s size.

​
Delete unused images and videos

  1. If you didn’t already, download your project as a backup before deleting any files.
  2. Prompt Bolt to find and remove media that isn’t being used in your project, such as multiple versions of an image you uploaded. You can use a prompt like: Find any images or videos that aren't being used in this project and delete them.
  3. Download a new copy of your project and check its size again.
If your project is now under 100MB, you can publish it. If it’s still over this limit, continue on to store your files outside of Bolt.

​
Move media files to an external storage service

Instead of storing images and videos in your project, you can host them with an external storage service and prompt Bolt to reference the external URL instead of the local file. Here are a few options to consider for external media storage. Except for Cloudflare Images, each provider has a free plan available. After choosing a storage provider, download your media files from Bolt, then upload them to the external service.

​
Prompt Bolt to reference your files from the external storage provider

When you move the media files outside your project, Bolt doesn’t automatically know where to find them. After moving each file:
  1. Prompt Bolt to update the location where it gets the image or video from. You can use a prompt like: Update references to the [file name] to use this URL instead: [URL]
  2. When Bolt finishes replacing the reference, delete the media file from your project. You can prompt Bolt to do this, or do it yourself from Code view.

​
”Site can’t provide a secure connection” error

If you see an error like this when publishing your site: This site can’t provide a secure connection.
<your-site>.bolt.host sent an invalid response.
ERR_SSL_PROTOCOL_ERROR the issue is usually related to your WiFi or router settings. Every internet provider and router setup is a little different, but most include an option to manage trusted domains. Open your WiFi or router settings, look for that area, and add .bolt.host to your list of allowed or trusted domains. If you still see the error after making that change, try connecting to a different WiFi network or use your phone’s hotspot. If your site publishes successfully, you will have confirmed the problem is with your original network settings rather than with Bolt.

​
Bolt failed to publish to Netlify

If Bolt fails to publish, you have the option of publishing manually to Netlify:
  1. Run the project build command (usually npm run build).
  2. Click Download to download the project.
  3. Follow Netlify’s Manual deploy instructions.
Bolt calls this feature Publish, whereas Netlify calls it Deploy.

​
Bolt loses connection to Netlify when duplicating projects

If you fork or duplicate your project, you’ll need to reconnect to Netlify. To do so, follow the steps in the Netlify integration guide. Doing this will create a new Netlify site, so you’ll need to make sure your custom domains are pointed to the new site:
  • If you bought your domain through Netlify and you’re using Netlify DNS, you can remove the domain from the old site and add it to the new one, all in Netlify. This Netlify support answer provides more information.
  • If you use another domain provider, look for their guide to updating domains.

​
Still stuck?

If your project still won’t publish, contact support.