Skip to content

Update Manage Posts documentation for current workflows #102

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bkatusic merged 1 commit into from
Jul 24, 2026
Merged

Update Manage Posts documentation for current workflows #102

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 20 additions & 23 deletions sites/content/manage-posts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ The Manage Posts feature lets you create, edit, schedule, and delete WordPress p
- Administrator access to your Dashboard site

<Note>
MainWP supports default WordPress post types. For custom post types, use the [MainWP Custom Post Types Extension](https://mainwp.com/extension/custom-post-types/).
Manage Posts handles standard WordPress posts. To manage custom post types, use the [MainWP Custom Post Types Extension](/add-ons/posts-pages/custom-post-types-extension).
</Note>

---
Expand All @@ -45,17 +45,16 @@ MainWP supports default WordPress post types. For custom post types, use the [Ma
<Steps>
<Step title="Navigate to Manage Posts">
Go to **MainWP > Sites > Content Operations > Manage Posts**.

![Go to MainWP > Sites > Content Operations > Manage Posts](/images/dashboard/sites-content-6e39b7.png)
</Step>
<Step title="Set search filters">
In the **Search Posts** section:

| Filter | Description |
|--------|-------------|
| Status | Filter by Published, Pending, Private, Scheduled, Draft, Trash |
| Keyword | Search for specific text in post titles or content |
| Date Range | Filter posts published within a date range |
| Status | Select one or more statuses: Published, Pending, Private, Scheduled, Draft, or Trash |
| Keyword | Search for specific text in the post title, body, or both |
| Date Range | Filter posts by their last-modified date |
| Max posts to return | Set the maximum number of posts returned per child site |
</Step>
<Step title="Select sites">
[Select the child sites](/getting-started/mainwp-user-interface) you want to search.
Expand All @@ -68,7 +67,7 @@ A list of matching posts appears at the bottom of the page.
</Steps>

<Note>
By default, MainWP returns a maximum of 50 posts per child site to prevent performance issues when loading large amounts of data.
The default **Max posts to return** value is 50 posts per child site. You can change the value before running the search.
</Note>

---
Expand All @@ -78,16 +77,15 @@ By default, MainWP returns a maximum of 50 posts per child site to prevent perfo
<Steps>
<Step title="Navigate to Add New">
Go to **MainWP > Sites > Content Operations > Manage Posts**, then click **Add New**.

![Go to MainWP > Sites > Content Operations > Manage Posts, then click Add New](/images/dashboard/sites-content-5eb0de.png)
</Step>
<Step title="Enter post content">
Complete the post fields:

| Field | Required | Description |
|-------|----------|-------------|
| Title | Yes | Post title |
| Content | Yes | Post body content |
| Title | No | Post title |
| Content | No | Post body content |
Comment on lines +86 to +87

@coderabbitai coderabbitai Bot Jul 24, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

# Inspect the relevant document section and nearby context.
git ls-files sites/content/manage-posts.mdx
echo '---'
wc -l sites/content/manage-posts.mdx
echo '---'
sed -n '1,140p' sites/content/manage-posts.mdx

Repository: mainwp/docs

Length of output: 4285

🌐 Web query:

MainWP "manage posts" title content required docs.mainwp.com

💡 Result:

In the MainWP Dashboard, when creating a new post via the Manage Posts feature (found under Sites > Content Operations > Manage Posts), both the Title and the Content fields are required [1]. When using the Manage Posts interface: - Title: This is a required field used for the post title [1]. - Content: This is a required field used for the post body content [1]. These fields must be completed before you can proceed to select your child sites and publish the post [1]. Other fields, such as Excerpt, Custom Fields, Discussion Settings, Featured Image, Tags, and Categories, are optional [1]. If you are using the MainWP REST API to create posts, the post_title and post_content parameters are also essential components for the creation process [2]. Extensions like the Article Uploader also rely on these components, where, for example, the first line of an uploaded TXT file is treated as the title and the remaining text as the body [3].

Citations:

🏁 Script executed:

#!/bin/bash
set -euo pipefail

sed -n '70,95p' sites/content/manage-posts.mdx

Repository: mainwp/docs

Length of output: 935

Mark Title and Content as required. The MainWP form/docs treat both fields as required, so this table should show Yes for each.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@sites/content/manage-posts.mdx` around lines 86 - 87, Update the “Title” and
“Content” rows in the field requirements table to mark both fields as required
by changing their values from “No” to “Yes,” while preserving the existing
descriptions.

| Slug | No | Post URL slug |
| Excerpt | No | Short summary |
| Custom Fields | No | Additional metadata |
| Discussion Settings | No | Comment and pingback options |
Expand Down Expand Up @@ -139,11 +137,9 @@ Go to **MainWP > Sites > Content Operations > Manage Posts** and search for the
</Step>
<Step title="Edit">
Find the post in the results and click **Edit**.

![Edit action button in posts table row](/images/dashboard/sites-content-d8b284.png)
</Step>
<Step title="Update">
Make your changes and save.
Make your changes and click **Publish**.
</Step>
</Steps>

Expand All @@ -156,9 +152,7 @@ Make your changes and save.
Go to **MainWP > Sites > Content Operations > Manage Posts** and search for the post.
</Step>
<Step title="View">
Find the post in the results and click **View**.

![View action button in posts table row](/images/dashboard/sites-content-a3c31c.png)
Find a published post in the results and click **View**.

The post opens on its child site in a new tab.
</Step>
Expand All @@ -175,9 +169,12 @@ The post opens on its child site in a new tab.
Go to **MainWP > Sites > Content Operations > Manage Posts** and search for the post.
</Step>
<Step title="Change status">
Find the post and click the status action (**Unpublish**, **Publish**, etc.).
Open the post's actions menu and select the available status action:

![Posts table showing list of found posts](/images/dashboard/sites-content-37e54a.png)
- **Publish** for draft or scheduled posts
- **Approve** for pending posts
- **Unpublish** for published posts
- **Restore** for trashed posts
</Step>
</Steps>

Expand All @@ -196,7 +193,7 @@ Select the action from **Bulk Actions** dropdown and click **Apply**.
</Steps>

<Note>
Available actions depend on the current post status. Published posts can be unpublished, scheduled posts can be published, etc.
Bulk actions include **Publish**, **Unpublish**, **Trash**, **Restore**, and **Delete**. MainWP applies an action only to selected posts whose current status supports it.
</Note>

---
Expand All @@ -211,8 +208,6 @@ Go to **MainWP > Sites > Content Operations > Manage Posts** and search for the
</Step>
<Step title="Trash">
Find the post and click **Trash**.

![Posts table with Trash action option](/images/dashboard/sites-content-85089f.png)
</Step>
</Steps>

Expand All @@ -231,6 +226,8 @@ Find the post and click **Delete**.
</Step>
</Steps>

For multiple trashed posts, select them using checkboxes and use **Bulk Actions > Delete**.

---

## Self-Check Checklist
Expand All @@ -246,5 +243,5 @@ Find the post and click **Delete**.
## Related Resources

- [Manage Pages](/sites/content/manage-pages) - Page management documentation
- [Custom Post Types Extension](https://mainwp.com/extension/custom-post-types/) - Manage custom post types
- [Custom Post Types Extension](/add-ons/posts-pages/custom-post-types-extension) - Manage custom post types
- [Boilerplate Extension](/add-ons/posts-pages/boilerplate-extension) - Create content templates