PPPastePage
On this page

Documentation

Everything you need to know about publishing with PastePage.

Getting Started

What is PastePage

PastePage is the fastest way to publish HTML to the web. Paste your code, hit publish, and get a live URL instantly. No build tools, no hosting setup, no deployment pipeline.

It's designed for AI-generated HTML. Ask ChatGPT, Claude, or any AI to build you a landing page, portfolio, or tool — then paste the output into PastePage and publish it in seconds.

Every page gets a permanent URL at username.pastepage.co/slug. You can also connect your own custom domain.

Create an account

Sign up with your email and password. You'll be redirected to start your free 14-day trial.

After setup, you'll choose a username — this becomes your subdomain (e.g. yourname.pastepage.co). Once that's set, you're ready to publish.

Your first page

  1. Go to the editor
  2. Paste your HTML into the code panel
  3. Check the preview on the right
  4. Click Publish
  5. Your page is live — share the URL

The editor auto-generates a random slug (like swift-compass). You can change it before or after publishing.

Editor

Code panel

The left side of the editor is a full code editor with HTML syntax highlighting, line numbers, and bracket matching.

Paste a complete HTML document — everything from <!DOCTYPE html> to the closing </html>. PastePage publishes your HTML exactly as written.

Preview

The right side shows a live preview of your page in an iframe. It updates as you edit, so you can see changes in real time.

The preview also captures JavaScript errors and warnings — check the console panel at the bottom of the editor if something isn't working.

Publishing

Click the Publish button to make your page live. If it's a new page, it creates a fresh URL. If you're editing an existing page, it updates the content at the same URL.

After publishing, the page is immediately available at your URL. Caches are automatically purged so visitors always see the latest version.

Slugs & renaming

The slug is the URL path for your page — the part after the / in username.pastepage.co/my-page.

Slugs must be lowercase, alphanumeric with hyphens only, and up to 60 characters. You can rename a page's slug at any time — the old URL will return a 404 and the new URL will be live immediately.

Tip: If you create a page with the slug home, it will be served when someone visits your root domain (e.g. username.pastepage.co or www.yourdomain.com).

Prompt builder

The editor includes a built-in prompt builder that helps you create prompts for AI assistants. Click the Prompt tab in the editor to access it.

The prompt builder automatically includes:

  • Quality standards (meta tags, responsive layout, fonts, favicon, etc.)
  • Your current HTML code
  • Any images you've selected (with labels)
  • Your specific request

Write what you want in the text field, select any images to include, then click Copy Prompt. Paste it into any AI assistant (ChatGPT, Claude, Gemini, etc.) to get a complete HTML page back.

The prompt builder includes a link to the docs so the AI can reference PastePage's guidelines if needed.

Writing HTML

Page structure

Every page should be a complete HTML document:

  • Include <!DOCTYPE html>, <html>, <head>, <body>
  • Set a <title> and <meta name="description">
  • Include Open Graph tags for link previews (og:title, og:description)
  • Include the viewport meta tag for mobile responsiveness
  • Add a favicon (inline SVG data URI or emoji)
  • Use Google Fonts via <link> in the head
  • Use responsive layouts — flexbox/grid, fluid widths, no fixed pixel widths
  • Use semantic HTML elements (header, main, nav, section, footer)

Using JavaScript libraries

Use vanilla JS/CSS, or any framework or library via CDN — no build step needed:

  • React — via esm.sh (use Babel for JSX)
  • Tailwind CSS — via cdn.tailwindcss.com
  • Vue, Alpine.js, Three.js — via esm.sh
  • Any npm package — available via esm.sh, unpkg, or cdnjs

Everything must be in a single HTML file. All packages must be loaded via CDN — never use bare imports like import React from 'react'.

Forms & payments

For contact forms, use embed services like Formsubmit or Tally — just set the form's action URL to their endpoint.

For payments, use Stripe Payment Links — create a link in your Stripe dashboard and add it as a button in your HTML.

Never include API keys, secrets, or credentials in your HTML — it's publicly visible.

Images

Uploading images

Upload images from the Images tab in the editor or from the Images section on your dashboard. Images are automatically converted to WebP for optimal file size and quality.

Each image gets a permanent URL that you can use in your HTML.

Storage limit is 1GB total per account, with a maximum of 10MB per file.

Image labels

You can add a short label to each image (up to 40 characters). Labels help you identify images later — especially useful when AI tools list your images via MCP.

Labels are editable inline — click the label text below any image thumbnail, type a description, and press Enter or click away to save.

When you upload an image, the original filename is used as the default label. You can change it at any time.

Using images in HTML

Copy the URL from the images panel (click the copy icon next to any image) and use it in an <img> tag in your HTML.

Images are served globally and cached aggressively — they load fast everywhere.

Custom Domains

Connecting a domain

Go to Settings → Custom Domain. Enter your domain as www.yourdomain.com — the www. prefix is required.

After connecting, you'll see DNS records to add at your domain registrar.

DNS setup

After connecting your domain, the Settings page will show the exact DNS records you need to add. You'll need to add two records at your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.):

  1. A CNAME record for www
  2. An A record for @ (root domain)

DNS changes can take up to 48 hours to propagate, though most take only a few minutes. Use the "Check status" button in Settings to verify.

SSL certificates

SSL certificates are provisioned automatically once your CNAME record is verified. You don't need to do anything — your site will be served over HTTPS within minutes of DNS validation.

Apex redirect

The CNAME record is required — it connects www.yourdomain.com to PastePage. The A record is also recommended — it redirects yourdomain.com (without www) to www.yourdomain.com so visitors can reach your site either way.

AI Integration (MCP)

What is MCP

MCP (Model Context Protocol) lets AI assistants like Claude interact with PastePage directly. Instead of copying and pasting HTML, you can tell your AI to "publish this to PastePage" and it happens automatically.

PastePage's MCP server URL:

https://mcp.pastepage.com/mcp

Setup with Claude

On claude.ai (Pro or Max plan):

  1. Go to Settings → Connectors
  2. Click "Add custom connector" at the bottom
  3. Enter the MCP server URL:
https://mcp.pastepage.com/mcp
  1. Click "Add" to finish
  2. In a new conversation, click the "+" button (bottom left) → Connectors → enable PastePage

Claude will open a browser window for you to sign in to your PastePage account. After authorizing, Claude can create, edit, and manage your pages directly.

You can manage connected AI apps in Settings → AI Connections.

Available tools

Once connected, your AI has access to these tools:

ToolDescription
list_pagesList your published pages (paginated)
get_pageRead the HTML of a page
create_pagePublish a new page
update_pageReplace a page's HTML entirely
patch_pageMake targeted edits (find & replace)
check_errorsCheck a page for JavaScript errors
upload_imageUpload an image from a URL
list_imagesList your uploaded images (paginated)

Password Protection

Adding a password

You can password-protect any page from the editor. Click the lock icon next to the slug field and enter a password. The password is saved when you publish.

To change or remove a password, click the lock icon again. Leave the field empty to remove protection.

You can view and manage page passwords from your dashboard — look for the lock icon on protected pages.

How visitors see it

When someone visits a password-protected page, they see a clean password prompt. After entering the correct password, they get access for that browser session — they won't need to re-enter it on refresh.

The password session is scoped to the specific page. Access to one protected page doesn't grant access to another.

Billing

Plan

PastePage has one simple plan that includes everything — up to 1,000 pages, 1GB of image storage, custom domains, AI integration, and password protection. New accounts start with a 14-day free trial — no charge until the trial ends. See the homepage for current pricing.

You can manage your subscription, update your payment method, and view invoices from Settings → Billing → "Manage billing."

Cancellation

You can cancel anytime from the Stripe billing portal (Settings → Billing → Manage billing). Your pages stay live until the end of your current billing period.

After your subscription ends, your account enters an archived state:

  • Your pages return 404 (they're not deleted, just not served)
  • You can still sign in and download your page HTML files
  • Your custom domain is preserved
  • After 30 days, pages and images are permanently deleted

Resubscribing

If you resubscribe within 30 days of cancellation, everything is restored instantly — your pages go live again, your custom domain works, and it's like you never left.

Limits

ResourceLimit
Pages per account1,000
Page size25 MB
Image storage1 GB total
Image file size10 MB per file
Slug length60 characters
Image label length40 characters
Page viewsUnlimited
BandwidthUnlimited

Account

Change password

Go to Settings → Change Password. Enter your current password and your new password (minimum 8 characters).

If you've forgotten your password, use the forgot password page to reset it via email.

Support

For any questions or issues, contact support@pastepage.com.