Core concepts
Publishing posts
Using Paragraph, you can publish content to a blog/newsletter.
The Basics
Create new posts in your dashboard. Click New post
and begin typing.
Within your dashboard, you can add a title, categories, or body text.
Your title is exactly how it sounds - a post title.
Categories are used to keep your content organized in your dashboard, as well as in your public-facing blog. For example, your readers can click on a post category and browse all posts filed under that category.
Your body text is where your actual post content goes. Press /
and insert callouts, images, and more.
Any text you type here is saved automatically -- no need to perform a manual save.
You can switch between [WYSIWYG](https://www.techtarget.com/whatis/definition/WYSIWYG-what-you-see-is-what-you-get#:~:text=A%20WYSIWYG%20(pronounced%20%22wiz%2D,see%20is%20what%20you%20get%22.) and raw markdown editing by using the toggle at the bottom.
You can also modify your post settings by clicking the gear at the top right. Choose a cover image, modify the post slug, and add a friendly post preview.
When you're ready to publish, just hit 'publish'. You'll now have the option to specify a few final things before your post is live - you can publish in a community, send a newsletter, or store on Arweave.
Communities
Communities are a way to sub-divide your newsletter. You can create a community for weekly updates; a community for DAO news; and a community for your friends & family. When you publish a newsletter, you can choose exactly which communities should receive it.
When users subscribe to your newsletter, by default they'll be subscribed to all communities, but they can self-select the communities they'd like to be a part of.
You can even token-gate individual communities!
SEO
Paragraph is heavily optimized for SEO, which will help your publication get discovered on search engines.
- We render everything statically. This means ultra-fast page loading, and no need to pull in information via APIs on page load.
- All uploaded images are properly resized and optimized using next/image. On page load before the image is rendered, they're blurred, preventing layout shift.
- Unlike other newsletter platforms, we host all content on the top-level https://paragraph.xyz domain (rather than a https://yourname.paragraph.xyz subdomain. This means Paragraph's SEO ranking gets shared with your newsletters.
- We auto-generate meta tags and social text, but you can specify your own in every post to further customize.
- We auto-generate a descriptive post slug (URL structure is important for SEO ranking). You can optionally specify your own.
- We link all posts in our sitemap, exposing them to web crawlers.
- We've optimized cumulative layout shift (CLS), largest contentful paint (LCP), and other core web vitals, all of which are important to crawlers.