Publish your articles

Add your blogs

Open Publishing. The first time, it asks Where's your blog? Type the address your articles should live at, such as example.com/blog, and click Add blog.

A project can publish to several blogs, each with its own address and method. Add blog at the end of the list adds another. New articles go to the blog marked Default. Each row's … menu has Make default and Delete.

Pick a method

Click Settings on a blog, pick a method under Publishing method and click Save. A new blog starts on copy and paste.

With GitHub or API picked, a Settings button opens that method's page. For the API key, code samples and webhook, see API and webhooks.

Publish an article

Click Publish in the editor. The popover's head shows the blog the article goes to, and picks another. Once an article is live, it stays on its blog.

The rows set what goes out with the article. Copy and paste only has Slug.

• Slug: the end of the article's address. You can change it until the article goes live.
• Author: who signs the article. With nobody picked, whoever created it signs it. Type a name to add a new author.
• Topic: one of your prompt topics. ByDefault suggests one from the article's text.

What happens next depends on the method:

• Copy and paste: click Copy article. Rich editors like WordPress or Notion get the headings, lists, links and images, and markdown editors get markdown. Paste the title into your blog's own title field. The article shows Copied until ByDefault finds it on your blog, then it turns Published.
• API: click Publish now. Your site gets the article as it was when you published, and Update sends your later edits. Unpublish takes it out of the API and tells your site through the webhook.
• GitHub: the button says what it does, such as Commit to main or Open pull request. The arrow beside it changes that for this article only. Review shows the file first.

Publish through GitHub

1. Pick GitHub as the blog's method and click Save.
2. Click Settings next to GitHub, then Connect GitHub. On GitHub, only grant access to the repository your blog is in.
3. Pick the Repository and click Save.
4. Pick the Folder your posts live in, and Publish as: Pull request or Commit to main. Click Save.

ByDefault names files the way your posts in that folder already do. To change it, open Advanced and pick a File name: my-example-title.mdx, a date prefix like 2026-10-22-my-example-title.mdx, or a folder per post like my-example-title/index.mdx.

The Frontmatter table lists the keys at the top of your posts and where each value comes from: the article (Title, Slug, Description, Publish date, Updated date or Authors), Ask when publishing, or a Fixed value. Ask when publishing adds a row for that key to the popover. Add field offers keys that only some of your posts use.

If your posts name authors by short names like josh, the Authors row says Incomplete. Click it and link each name to an author in ByDefault.

Review opens the file exactly as ByDefault will commit it, or the changes when the file already exists. Edit the commit message there, or click Copy markdown to take the file with you.

Authors

Publishing → Authors lists the people shown as the writer of your articles. When you add people to your organization, they're automatically added as authors. Click Add author for anyone else, such as a guest writer, and give them a name and a photo.

When you remove an author, their articles go back to whoever created them. A member's author stays while they're in the project.

Troubleshooting