Custom HTML Homepage

View Dashboard > Settings > Homepage

Superblog can show either your regular post feed on the homepage or a custom HTML experience that you upload as a .zip file.

This is useful when you want a custom landing page, pricing page, campaign microsite, or other hand-built pages while still keeping Superblog for your blog content.

What you upload

Upload a .zip file containing your HTML files and related assets.

Examples:

• index.html

• pricing.html

• contact.html

• CSS, JS, image, and font files used by those pages

• optional sitemap.xml

How it behaves

If your ZIP includes index.html

• index.html becomes your new homepage.

• Your regular blog listing moves to /posts/1.

This is the right option when you want the root URL to behave like a custom website homepage.

If your ZIP does not include index.html

• your normal blog homepage stays as the homepage

• the other uploaded HTML files are still available at their own paths

This is useful when you want extra standalone pages without replacing the main blog homepage.

Sitemap behavior

You can include your own sitemap.xml inside the ZIP for custom pages.

Superblog handles this without conflicting with the blog sitemap. The generated robots.txt can reference:

• Superblog's own sitemap

• your uploaded sitemap from the ZIP, if it exists

Why this is useful

This setup gives you a flexible hybrid structure:

• custom marketing pages from your ZIP

• blog posts and blog archives from Superblog

• one deployment flow for both

Typical use cases

• custom landing pages for ads or campaigns

• a custom pricing or product page

• a branded homepage with your own HTML and JS

• static support or docs pages outside the normal post system

Things to keep in mind

• Upload a real .zip file, not a folder.

• Make sure all linked assets are included in the ZIP.

• If index.html is missing, the homepage will not be replaced.

• If you upload index.html, remember your posts move to /posts/1.

Best practices

• Keep your custom pages lightweight and fast.

• Include only the files you need.

• Test all internal links after upload.

• If you rely on search discovery for custom pages, include a sitemap.xml in the ZIP.

• Decide intentionally whether the root URL should be your blog or your custom landing page.

When to use this feature

Use the custom HTML homepage option when the standard Superblog homepage is not enough for your front-page experience, but you still want Superblog to manage your blog posts, publishing, and SEO-friendly content structure.