Troubleshoot content issues

Common issues may occur while using the content editor or when viewing live HubSpot-hosted content. This article outlines common content issues and the steps to diagnose and resolve them.

Please note: if HubSpot Support or the HubSpot Status page confirms an ongoing incident affecting editors or previews, there's no immediate resolution while the incident is active. Monitor the HubSpot Status page or subscribe to updates to stay informed. Retry after the incident is marked as resolved. If the issue persists after resolution, contact HubSpot Support.

Content editor won't save changes

Changes may not save if the content is open in multiple browser tabs or on multiple devices at the same time. A dialog box may alert you that your changes aren't being saved in the content editor. 

Close duplicate editor sessions

1. In the dialog box, click Go back to editor. 
2. Copy any content updated since the last save. 
3. Close any duplicate browser tabs or windows displaying the same content. If no duplicates exist, view the revision history to confirm if another user has been editing the content on a different device. 
4. Reload the content editor to load the most recently saved version. 
5. Paste the copied content back into the editor. 
6. When finished, click Save.

Clear browser data if the issue persists

1. Clear your cookies and cache.

2. Try accessing the editor in a different browser. 

Published content is displaying a 404 error

A 404 error appears when a live page doesn't exist at the URL entered in the browser.

Confirm the page is published

1. Verify the content has been published in HubSpot. 
2. Confirm the URL entered in the browser exactly matches the page URL. 

Confirm redirects and URL parameters

1. Remove any URL parameters and test again. 
2. Confirm no broken URL redirects use this URL as the Original URL. 

Confirm DNS and network conditions

1. Confirm there are no DNS issues with your domain provider.
2. Test the page on another network to rule out network issues. 

Content won't load on a specific network 

If your HubSpot-hosted content loads on some networks but not others, the issue may be related to internal DNS configuration.

Test for a network-specific issue 

1. On a mobile device, turn off Wi-Fi to use your cellular data network.
2. Attempt to access the content.
   • If the content loads, the issue is likely specific to the original network. In this case, visitors not using that network should be able to access the content without issue.
   • If the content doesn't load, review the 404 troubleshooting steps.

Verify internal DNS configuration

1. Work with your IT team or network administrator.
2. Confirm CNAME records in the network's internal DNS configuration match the records in HubSpot.

Content hosted on SSL displays mixed-content warnings

Mixed-content warnings occur on a secure (https) HubSpot-hosted page with SSL when an external resource (e.g., an external stylesheet) tries to load from an insecure (http) source. To resolve this, you can either update the asset's URL or upload the asset to HubSpot.

Update insecure asset URLs 

1. In your HubSpot-hosted content, locate the URL for the external asset causing the warning. Common sources include:
   • src attributes of images in rich text or custom HTML modules.
   • @font-face declarations for external fonts.
   • @import external stylesheet references.
2. In the insecure URL (http), edit the prefix to https.
3. Publish your changes then reload the content to confirm the warning is resolved. If the asset fails to load, it may not be available over a secure URL (https). In this case, you'll need to upload the asset.

Upload the asset to HubSpot

1. Download the asset from its external source. 
2. In your HubSpot account, navigate to Content > Files. If you're using HubSpot's free tools, navigate to Marketing > Email. In the top right, click Email tools and select Files.
3. On the File page, click Upload files in the top right.
4. Select and upload the asset file. 
5. Once uploaded, click the name of the file.
6. In the right panel, click Copy URL. 
7. Return to your content and replace the insecure URL (http) with the new URL (https). 
8. Publish your changes then reload the content to confirm the warning is resolved.

Learn more about how stylesheets are attached to content in HubSpot. 

Template updates aren't reflected in existing content

Changes to locked modules and global modules apply automatically to existing content, but changes to other modules don't.

Lock a module in the design manager

1. In your HubSpot account, navigate to Content > Design Manager.
2. In the finder, click the name of your template. 
3. For drag and drop templates:
   • In the layout editor, right-click the module, 
   • In the inspector, toggle the Prevent editing in content editors switch on.
4. For coded templates:
   • In the code editor, locate the module. 
   • Add the overrideable parameter. Learn more about using parameters with modules.
5. In the top right, click Publish changes. 

Trigger content to re-render

If changes to locked or global content aren't appearing in live content:

1. In the content editor, make a small edit to the content (e.g., add a space). 
2. Click Publish or Update to take the changes live.