Manage Pages

You have a variety of ways to manage your pages as you edit them.

Preview Page

You can preview a page by clicking on the preview page icon next to the save button. It will open up the page in a new tab, and should work for public, and unlisted pages.

321321

Publish Pages

476476

When pages are created, they will go live instantly. If you do not want your page to go live, make sure to switch the "live" setting to off:

17061706

Unlist Pages

468468

To unlist a published doc, go to the dropdown next to the save button and toggle Published? off.

❗️

Caution

There is no confirmation box when unlisting pages. Changes will take effect immediately.

Change Page URL

Click the dropdown next to the save button, then choose change page slug to edit the page URL. Don't forget to Save.

364364

Page Options

Hover over any page to reveal three options:

540540

Hover over any page to see these icons.

Add Subpage

411411

The "+" icon will add subpage

Subpages are nested within the parent page where the "+" icon was clicked. To create a regular page, click the "+" icon next to the Category name.

📘

Subpages

The "+" icon is not available on subpages.

Clone Page

411411

The duplicated page will be created directly below the original page.

If the duplicate page is saved with the same Page Title, ReadMe will add "-1" to the page URL.

Example:
Original Page URL: /docs/introduction
Duplicate Page URL: /docs/introduction-1

Delete Page

411411

You must confirm that you want to delete the page, as it we cannot recover it if deleted.

450450

Reorder Page

417417

Drag a page to any other location, including other categories. Subpages will move with the page being dragged.

❗️

Caution

There is no confirmation box when reordering pages. Changes will take effect immediately.

Moving Categories Between Documentation and Reference

There is a button next to the category name that allows you to move categories between Documentation and Reference, as long as there are no API reference pages within the category.

432432

Using the ReadMe Docs API

You can also manage your docs using our Docs API, which allows you to return, update, delete, create, and search documentation pages.

888888

Sync'ing ReadMe docs via CLI or GitHub Action

ReadMe's official command-line interface (CLI) and GitHub Action, rdme, can help sync your Markdown docs and even your OpenAPI file. This is useful for CI, or customers who may keep their documents hosted in a repository. You can read more about rdme on the dedicated docs page.


Did this page help you?