How to put an HTML file on your Squarespace site
Quick answer
Squarespace has no way to make an .html file a page of your site. Paste the file's code into a code block set to HTML: it holds up to 400 KB, and JavaScript or an iframe needs the Core, Plus, or Advanced plan. The link editor uploads the file up to 20 MB as a link. For a whole page with scripts and forms, publish it at its own address and link a button to it.
Free plan: no credit card, 1 published page.
On this page
You have an .html file, perhaps a landing page, a calculator, or a quiz that ChatGPT or Claude made, and a site on Squarespace. Squarespace builds pages from its own blocks, so a file doesn't become a page the way it does on a host that serves files. What Squarespace offers is a code block on one of your pages, a file link, and buttons. This guide gives each, with its limits, from Squarespace's Help Center, read on November 20, 2026.
To check the page first, drop it into the upload box at the top of this page: it gives a preview link without an account. That preview runs no scripts. Click Keep this page — free, no card and sign up, and the page moves into your account, where its scripts run and you can publish it at a link your Squarespace site points to.
What Squarespace allows
| What you want | Squarespace's tool | What Squarespace says |
|---|---|---|
| Show the HTML on a page | Code block, Mode HTML | "Code blocks have a 400 KB limit, or about 300,000 characters" |
| Run its JavaScript | The same code block | "To add JavaScript or an iframe to a code block, your site needs to be on the Core, Plus, or Advanced plan" |
Upload the .html file | The link editor, File | "Each file needs to be 20 MB or smaller." Visitors "click the link to open or download the file" |
| Send visitors to the page | A button or a text link | The page opens at its own address |
Paste the code into a code block
This puts the page's code on one of your Squarespace pages.
- Edit a page or post.
- Hover over the section and click Add block or +, then click Code.
- Click the pencil icon on the block to open its editor.
- In the Mode menu, choose HTML, and paste the code.
- Leave Display Source off: switched on, it shows the code as text.
- Save, and publish the page.
Squarespace's rules for the code:
- 400 KB. "Code blocks have a 400 KB limit, or about 300,000 characters." A page with pictures written into it as data can pass that.
- Scripts take a plan. "To add JavaScript or an iframe to a code block, your site needs to be on the Core, Plus, or Advanced plan."
- CSS and JavaScript go in tags. "To render CSS or JavaScript, select HTML in the Mode menu, then wrap CSS in tags and JavaScript in tags." Set to CSS or JavaScript, the block shows the code as text.
- You may not see it while logged in. "As a security measure, your code sometimes doesn't appear while you're logged in, even when visitors can view it." Squarespace's fix: "click Preview in Safe Mode."
- Ajax loading and index pages. "Custom code might not render if you added it to a page in an index page, or if Ajax loading is on."
A code block sits inside your page, under your site's header, so a whole page an AI made shows inside your Squarespace layout, not full screen. For the whole page, link it as below.
Upload the file as a link
The link editor takes the .html file itself:
- Select text or a button and open its link editor.
- Select File from the drop-down menu.
- Click the upload icon and choose the file. "Each file needs to be 20 MB or smaller."
Squarespace says "When a visitor clicks a file link, the file opens in their browser", and "A visitor's own browser settings can also decide whether a file opens or downloads." Files beside the page, such as style.css or game.js, need their own upload and their own address, so ask the AI for one file with everything inside.
Link a button to the page
A page at its own address keeps its whole layout and runs its scripts on every Squarespace plan:
- Publish the page on a host and copy its
https://address. - Add a Button block, or select a word, and open its link editor.
- Paste the address, and switch Open link in new tab on if you want it.
A Convika page refuses to be shown in a frame on another site, so link it this way rather than in an iframe.
Ways to put an HTML file on Squarespace, compared
| Way | Where it shows | Scripts run | Plan |
|---|---|---|---|
| Code block, Mode HTML | Inside one Squarespace page | Yes, on Core, Plus, or Advanced | JavaScript and iframes: Core, Plus, or Advanced |
| File link | The file, opened or downloaded by the visitor's browser | Up to the visitor's browser | Any |
| A button to the page | The page's own address | Yes, if its host runs them | Any |
Publish the page on Convika and link it from Squarespace in 4 steps
Convika serves one .html or .htm file up to 2 MB, or pasted code, at a lasting link, with its HTML, CSS, and JavaScript as they are.
1. Get a preview link
Drop the file into the upload box at the top of this page, or paste the code, and click Get my preview link. You get a link in seconds, without an account. It works for 3 minutes, with scripts and forms off, so it's for checking the layout. If the page's CSS and images sit in a folder next to it, drop that folder, or a zip of it, and the box puts them inside the file.
2. Keep the page
Click Keep this page — free, no card and sign up. The page moves into your account, and its scripts run in the dashboard preview.
3. Publish it
Click Publish page. Under Who can open this page?, choose Public and click Next. The first time, click Publish free: the page goes live with a small Convika bar at the bottom. Under it, a second button buys the Pro pass ($5 once for 30 days, no auto-renewal) and publishes the page without the Convika bar. On Free, the page is Public: anyone with the link can open it, and it may show up in search results and in Convika's gallery.
4. Link it from Squarespace
Copy the page's address, such as yourpage.convika.page. In Squarespace, add a Button block, open its link editor, paste the address, and save.
Free includes 1 published page and 10,000 page views a month, and the dashboard shows how many people opened the page. A form on the page collects the entries in your dashboard. Is Squarespace's own plan worth it? Is Squarespace free? covers its trial and plans.
Skipbox
Cheap & fast GitHub Actions runners, unlimited for $39 a month
Your own machine keeps Docker layers and package caches between jobs. Switch by changing one runs-on line.
Start a free Skipbox trialFrequently asked questions
Can you upload an HTML file to Squarespace?
As a file link, yes: in the link editor, select File and upload it, up to 20 MB, and visitors' browsers open or download it. It doesn't become a page of your site. To show the page on a page, paste its code into a code block set to HTML; to keep it whole, publish it at its own address and link a button to it.
How do I add custom HTML to Squarespace?
Add a Code block: edit the page, click Add block or +, click Code, open it with the pencil icon, choose HTML in the Mode menu, and paste the code. A code block holds up to 400 KB. JavaScript and iframes need the Core, Plus, or Advanced plan.
Why isn't my HTML code showing on Squarespace?
Squarespace gives three causes. Code sometimes doesn't appear while you're logged in, so click Preview in Safe Mode. Code can fail on a page inside an index page or with Ajax loading on. And a block set to CSS or JavaScript, or with Display Source on, shows the code as text: set Mode to HTML.
Does Squarespace allow JavaScript?
In code blocks, on the Core, Plus, or Advanced plan: "To add JavaScript or an iframe to a code block, your site needs to be on the Core, Plus, or Advanced plan." Put the JavaScript inside <script></script> tags in a block set to HTML. A page at its own address, linked from a button, runs its scripts on any plan.
How do I add an HTML page to Squarespace without a code block?
Publish the page at its own https:// address, then add a Button block on your Squarespace page and paste the address in its link editor. The page opens with its whole layout, scripts, and forms, and Squarespace's plan doesn't limit it.
Sources
- Add custom code to a page with code blocks (Squarespace Help Center) (no date shown; read November 20, 2026)
- Upload, rename, and delete files on your site (Squarespace Help Center) (last updated October 9, 2026; read November 20, 2026)
Next step
How to password protect an HTML page or website
A JavaScript password script leaves the password in the page source. To password protect an HTML page or link, encrypt the file or let a server check it.
Related articles
- How to put an HTML file on your Wix siteWix's editor shows HTML in an Embed HTML or Embed a site iframe, not as its own page. Wix Headless takes a static site upload. Steps and limits from Wix's help.
- How to upload an HTML file to WordPressOn self-hosted WordPress, upload the file by SFTP or paste it into a Custom HTML block. WordPress.com strips scripts on Free. What works on each, from the docs.
- Is Squarespace free? No free plan: a 14-day free trial, then a paid planNo: Squarespace has no free plan, only a 14-day free trial, and sites stay private. The Basic plan costs $19 a month, billed yearly.
- How to share an HTML file as a link that opens on any phoneUpload the file to a host and send its link; email and Google Drive send the code. 8 hosts compared, from Convika to Netlify Drop, with 4 steps.
- HTML contact form: copy the code and get every message by emailCopy a styled HTML contact form and an email signup form. Host the page on Convika: each message is saved, emailed to you, and exported as CSV. No PHP.
- Can I put a page ChatGPT or Claude made on my own domain without paying for hosting?Yes, you pay only for the domain. Convika's Free plan connects www.yourbrand.com with 2 DNS records and issues HTTPS. The records Cloudflare Pages, GitHub Pages, Netlify, and Vercel ask for, too.