Introduction
Use this guide to resolve two common Page Builder issues: the Publish option is greyed out, or a homepage returns a 404 error after publishing. In most cases, these problems are caused by missing required fields, incomplete page content, permission restrictions, or an incorrect URL path configuration.
Issue description
You may see the Publish button disabled while editing a homepage in Page Builder, or the page may publish successfully but still show a 404 error when you open the URL. These issues usually indicate that the page is not fully configured or that the published URL does not match the expected path.
Signs
- The Publish option is greyed out or unavailable.
- The page cannot be published even after editing content.
- The homepage publishes, but the URL returns a 404 error.
- The published page opens to a different path than expected.
Basic troubleshooting steps
Start by checking the most common causes below.
Confirm that all mandatory fields are completed.
- Page Name is filled in.
- Page URL is set correctly.
- Page Type is selected.
- SEO metadata is completed, if required.
- All required content sections are present.
Check that the homepage includes every required section for your Page Builder setup. Some templates require specific blocks before publishing is enabled.
Save your changes and refresh the editor before trying to publish again.
If the Publish option is still greyed out, verify that your user role has permission to publish pages.
Advanced troubleshooting steps
Step 1: Complete all required page fields
Open the homepage in Page Builder and review each required field. Make sure the Page Name, Page URL, and Page Type are all populated. Add any required SEO metadata, such as title and description, and confirm that every mandatory content section has been added to the page.
Step 2: Check page content requirements
Some homepage templates require specific content sections before publishing is allowed. Review the page layout and ensure no required sections are missing, empty, or unpublished. If a section is optional in your template, it may still be required for your specific configuration.
Step 3: Verify permissions
If the Publish button remains disabled after all required fields are completed, check whether your account has permission to publish pages in Page Builder. If you do not have the correct access level, ask an administrator to review your role permissions.
Step 4: Verify the URL path configuration for 404 errors
If the page publishes but returns a 404 error, review the Page URL and path settings. Confirm that the published URL matches the expected site structure and that the homepage path is configured correctly. If your site uses a custom path or locale-specific route, make sure the published page is assigned to the correct path.
Step 5: Republish and test the page
After correcting the fields or URL path, save the page and publish it again. Then open the live URL in a new browser tab to confirm that the homepage loads correctly and no longer returns a 404 error.
Contact support
Contact support if the Publish option is still greyed out after completing all required fields and verifying permissions, or if the homepage continues to return a 404 error after you confirm the URL path configuration. Include the page name, page URL, screenshots of the editor, and any error messages so support can investigate faster.
Additional resources
- Related article: [Page Builder publishing requirements]
- Related article: [Managing page permissions]
- Related article: [Configuring page URLs and paths]
Conclusion
A greyed-out Publish button usually means one or more required fields or page sections are missing, or your permissions need to be updated. A 404 error after publishing usually points to an incorrect URL path configuration. By checking the required fields, permissions, and page URL settings, you can usually resolve the issue without further assistance.