Help & Documentation
Getting Started
StaticPress is a WYSIWYG editor for Hugo static site blogs. It connects to your GitHub repository and lets you create and edit posts through a clean, visual interface.
Option 1: Create a New Blog
- Sign in with GitHub
- Click "Create New Blog" on the setup page
- Enter your blog name and description
- StaticPress creates a GitHub repository with Hugo pre-configured
- Start writing!
Option 2: Connect Existing Blog
- Sign in with GitHub
- Select your existing Hugo repository
- Set the content path (default: content/posts)
- Your existing posts will appear in the sidebar
Creating Posts
Writing a New Post
- Click the "New Post" button in the sidebar
- Enter a title for your post
- Write your content using the rich text editor
- Click "Publish" to make it live, or "Save Draft" to save without publishing
Editing Existing Posts
Click on any post in the sidebar to load it into the editor. Make your changes and click "Publish" to update the post on your site.
Deleting Posts
Hover over a post in the sidebar and click the delete icon. Confirm the deletion when prompted. This removes the post from your GitHub repository.
Editor Features
The StaticPress editor supports rich text formatting:
- Bold and Italic text
- Headings (H2, H3)
- Bulleted and numbered lists
- Block quotes
- Code blocks
- Horizontal rules
- Links
- Images (paid tiers)
Adding Images
With a paid subscription, you can add images to your posts:
- Click the Image button in the toolbar
- Or paste an image directly from your clipboard (Ctrl/Cmd+V)
- Images are automatically uploaded to your GitHub repository
Deployment
Your Hugo blog can be deployed to various platforms. Here are the most popular options:
GitHub Pages (Easiest)
- Go to your repository Settings on GitHub
- Click "Pages" in the sidebar
- Under "Source", select "GitHub Actions"
- Your blog will deploy automatically on each push
- Access it at: username.github.io/repo-name
Cloudflare Pages
- Sign up at pages.cloudflare.com
- Connect your GitHub account
- Select your repository
- Set build command:
hugo - Set output directory:
public
Vercel
- Sign up at vercel.com
- Import your GitHub repository
- Vercel auto-detects Hugo projects
- Click Deploy
Netlify
- Sign up at netlify.com
- Connect your GitHub repository
- Set build command:
hugo - Set publish directory:
public
Subscription Tiers
Free
- Edit your 5 most recent posts
- Rich text editor
- GitHub sync
Personal - $2.50/month
- Edit all of your posts
- Image uploads
- Clipboard paste for images
Your own address - $5/month
- Everything in Personal
- Your own web address, with step-by-step help
FAQ
How does StaticPress work?
StaticPress connects to your GitHub repository and uses the GitHub API to read and write Markdown files. When you publish a post, it commits the file to your repo, which triggers your site to rebuild.
Is my data secure?
Yes. We use GitHub OAuth for authentication and only request the permissions needed to read and write to your repositories. Your posts are stored in your own GitHub repository.
Can I use StaticPress with an existing Hugo blog?
Absolutely! Select "Connect Existing Blog" on the setup page and choose your repository. Make sure to set the correct content path for where your posts are stored.
What Hugo themes are supported?
StaticPress works with any Hugo theme. The editor creates standard Markdown files with YAML frontmatter that Hugo expects.
How do I change my blog's theme or settings?
Edit the hugo.toml file in your repository directly on GitHub, or clone the repo locally and make changes there. StaticPress focuses on post editing.
Can I cancel my subscription?
Yes, you can cancel anytime from the Pricing page. You'll continue to have access until the end of your billing period, then revert to the Free tier.
Need More Help?
If you have questions not covered here, please reach out at support@staticpress.me