Instructions for Content Type Manual

Create different content types

Menu path:Content Management System → ChestnutCMS。

This page explains how to create new articles, images, audio files, books, documents, and videos. It also describes the specific areas used for each type of editing page. All types share common fields such as title, category, cover image, author, editor, originality status, attributes, summary, tags, keywords, source, and release date. The main difference lies in the content editing area on the left side.

Start from the content list.

  1. Confirm the current site at the top of the page.
  2. In the left-side column tree, select the category to which the content belongs. The content will inherit the template, extensions, permissions, and workflow settings of that category.
  3. Click "Add" on the "Content List" tab.

![Content List]](/resources/image/2026/09/04/845253980827717.jpg)

If the “Add” button is not visible, or if you receive an error message after clicking it, indicating that a specific column must be selected first, please ensure that the correct column has been chosen. Also, verify that your account has the necessary permissions to add content to that column.

Select content type

The Chestnut CMS provides six types of content for the "Add" layer. When selecting "Article," you also need to decide whether to use "Rich Text" or "Markdown" for the body of the article. Then, click "OK" to enter the editing page.

Select content type.](iurl://resources/image/2026/09/04/845254074593349.jpg?type=resource&id=870680060657733&sid=870679897600069)

Content TypeApplicable scenariosFeatures of the editing area
ArticlesNews, Announcements, Tutorials, InformationRich text or Markdown editor
ImagePhoto collections, photographic works, product albumsImage list, capable of maintaining descriptions, links, and order.
Audio contentPodcasts, recordings, audio programsAudio list, capable of maintaining authors, covers, and descriptions.
BooksBook materials, serial publicationsBook metadata, introduction, and chapter management
DocumentsReport, white papers, download materialsSingle File and File Introduction Editor
VideoLocal videos, external video sharingMulti-video list, supports local and third-party video codes

Shared editing area

The editing pages for all content types contain the following sections:

  • Top Operation BarSave, submit for review, publish, preview, lock, related content, push to Baidu, operation records, add or remove items. The actual buttons depend on the column permissions and workflow configurations.
  • Title AreaPlease fill in the required title. There are buttons on the right side of the title, which allow you to expand the short title and subtitle. When “Link Content” is enabled, the text or media area will be replaced by a link address. This feature is suitable for external links or internal navigation purposes.
  • Basic attributesMaintain information related to columns, covers, authors, editors, original tags, content attributes, summaries, tags, keywords, sources, release times, decommissioning times, independent paths, and independent templates.
  • Extended configurationDisplays the extended model fields associated with the columns. If no extended models are associated with a column, this tab will be empty.

It is recommended that you fill in the title and category-related information first during editing, followed by filling in the basic attributes on the right side. The cover image, summary, and publication date are typically displayed on the list page.

Article

The article supports two formats for text formatting: rich text and Markdown. The format is determined during the creation of the document. It’s important to ensure that the chosen format aligns with the template requirements and the preferences of the editing team before saving the document.

Rich text articles

![Article Rich Text Editing Page]](/resources/image/2026/09/04/845254170951749.jpg)

The rich text editor is suitable for visual formatting. You can customize the font, paragraph spacing, links, images, tables, videos, etc. At the top of the editor, you can also find:

  • Download images: When saving the file, download the remote images included in the text. This ensures that the external images remain valid. Before using the files, make sure to check their copyright status and storage policies.
  • **Select the publishing channel style.**Import the style corresponding to the publishing channel, enabling editing with similar results as those achieved in the frontend.

After pasting the external content, make sure to clean up any unnecessary formatting. Also, use the “Preview” function to check the layout of images, tables, and other elements on mobile devices.

Markdown article

![Markdown editor page for articles]](/resources/image/2026/09/04/845254445371461.jpg)

In the Markdown editing area, you can enter the source code on the left side, while a preview is displayed on the right side. The toolbar allows for the insertion of common syntax elements. Additionally, it supports the upload of images, videos, audio files, as well as the insertion of links to various sections or content. This format is suitable for technical documentation and long documents that require version control. Before publishing, make sure that the template is correctly rendered according to Markdown syntax.

Article version records and version comparison

The articles that have been saved are displayed in the "Version History" section at the top of the operation bar. Before making significant changes to the text, you can open the "Version History" section and click "Save New Version" to keep the currently saved version of the text in the database as a historical version.

![List of article version records]](/resources/image/2026/09/04/845254557634629.jpg)

Version list displays version numbers, creators, and creation times. It also provides the following functionalities:

  • Compare with the latest versionSelect a previous version, or click “Compare with the latest version” for this row. This will allow you to compare the historical text with the currently saved text.
  • Compare: Select both historical versions, then click “Compare” to compare the text at two specified times.
  • Restore: Replace the current text with the text from the selected version. Note that this operation will modify the article data. Please save the current text as the new version before proceeding. After the restoration, re-preview, review, or publish the article is necessary.
  • Delete: Deleting historical versions that are no longer needed. Once deleted, these versions cannot be restored through the version records. Please ensure the purpose of the versions before performing this operation.

When you click “Save New Version”, it will read the text that has already been saved in the article. Any changes that are not yet saved on the editing page will not be included in the new version. It’s recommended to save a historical version before making changes, then close the version window, edit and save the article, before comparing it with the latest version.

Compare the historical versions of the article with the latest version.](iurl://resources/image/2026/09/04/845254621446213.jpg?type=resource&id=870680060698693&sid=870679897600069)

On the left side of the comparison page, older versions are displayed; on the right side, newer or latest versions are shown. Orange indicates replacements, green indicates new additions, and red indicates deletions. The comparison and restoration process applies only to the main text of the articles, excluding titles, summaries, covers, and other basic attributes. The rich text content is first converted into a format that makes comparisons easier to perform. Therefore, the comparison results are primarily used to determine changes in content, not to determine the overall appearance of the page.

Image

![Page for editing image content]](/resources/image/2026/09/04/845254690476101.jpg)

Click “Add Image” to select or upload images from the resource library. Multiple images can be added at once. Each image can have its own title, description, and link. You can also adjust the order of the images by moving them up, down, or setting them as covers. Additionally, you can crop, replace, or delete images as needed. It is recommended to arrange the images in the order they will be displayed when the page is rendered, and then choose the most representative image to use as the cover image.

Image item list

After adding images, multiple image items will be displayed in the editing area in sequence. Each item can also be considered as a chapter of images within the gallery.

![List of image entries and editing fields]](/resources/image/2026/09/04/845254768332869.jpg)

On the left side of each image entry, thumbnail, file size, and aspect ratio are displayed. On the right side, you can directly edit the following information:

  • TitleThe name of the image in the gallery or details page.
  • Abstract: Image descriptions, captions, or additional text.
  • Link: The URL that will be redirected to after clicking on the image. You can enter a external URL, or choose a section/content from the “Internal Links” option.

The "Move Up" and "Move Down" options at the bottom of the entry allow you to adjust the order of images displayed on the page. The "View" option enables you to view the large image. "Set as Cover" allows you to designate the current image as the cover image for the content. The "Crop" option enables you to adjust the size of the image. "Replace" allows you to update the image resource used in the display. "Delete" removes the image from the current collection. After sorting and editing the fields, you need to click "Save" at the top of the page for the changes to take effect.

Replace or edit the individual images.

Click on "Modify" for a certain entry to open the material library. You can switch between "Local Upload" and "Material Library", and search to select an image for replacement.

Select and replace single image materials on ChestnutCMS.](iurl://resources/image/2026/09/04/845254827257925.jpg?type=resource&id=870680060723269&sid=870679897600069)

After selecting the image from the material library and clicking “OK”, the new image will be applied to the current editing form. However, it must be saved at the top of the page for it to take effect. Before replacing the image, ensure that its size, aspect ratio, and file size are correct, to avoid any distortion in the list cards. Also, check whether the material has been reused by other elements before cropping it.

Audio

![Audio content editing page]](/resources/image/2026/09/04/845254882771013.jpg)

Click “Add Audio” to select or upload an audio file. After adding the file, the page will display information about the player and the file itself. You can modify the audio title, author, description, and cover image, as well as arrange the audio files in order. Before saving, listen to the audio file to ensure that its duration, format, cover image, and playback order are correct.

Video

![Video editing page]](/resources/image/2026/09/04/845254934618181.jpg)

The Chestnut CMS provides two ways to access the video editing area:

  • **Add videos.**Select or upload video files from the resource library. After adding them, you can specify titles, descriptions, and their order of arrangement. The cover image can be taken from a screenshot taken at a specific point in the video, or it can be uploaded separately as the cover image for the content.
  • Add third-party videosPlease enter the sharing code provided by the third-party platform. Before publishing, ensure that the source of the sharing code is trustworthy, that it can be embedded properly, and that it meets all the requirements for compatibility with CSP, security filtering mechanisms, and mobile devices.

File

![Page for editing file content]](/resources/image/2026/09/04/845254988402757.jpg)

The file type includes a file selection box and a rich text editor for describing the file. Click on the dashed box to select or upload files. After adding files, you can preview, replace, or remove them. In the file description section, you can enter information such as summary, version number, applicable scenarios, update date, and download instructions. Before saving the file, make sure to check its size, format, download permissions, and the link for downloading the file.

Book

![Page for editing book content]](/resources/image/2026/09/04/845255044886597.jpg)

The "Book Information" tab allows you to fill in the ISBN, publication date, publisher, number of pages, provider, number of words, original title, translator, price, whether it is completed, and book description.

The “Chapter List” is not available when creating a new chapter for the first time. Please fill in the title and book information first, then save them. After that, you can add, edit, sort, publish, or delete chapters using the “Chapter List”. The price is displayed in “fen” units; do not enter decimal amounts in “yuan” units.

Book chapter list

![List of Book Chapters]](/resources/image/2026/09/04/845266007445573.jpg)

After saving the main content of the book, switch to the “Chapter List” tab to manage the chapters. The list displays the chapter titles, status, and creation time. The chapter status includes draft, pending publication, published, etc. The buttons for different statuses vary in their functionality.

  • Click "Add" to open the separate chapter editing page; click "Edit" in the chapter row, or double-click on the chapter row to enter the editing page.
  • Use search options and sorting criteria to find the desired chapters. Multiple records can be selected and deleted at once.
  • The draft chapters can be modified, published immediately, scheduled for publication, or removed from the system. The chapters that are ready to be published can also be modified, published, taken offline, or deleted. The chapters that have already been published can be revoked by setting them to “offline”.
  • The publication status of each chapter is independent of the main book. Before publishing a book, it is necessary to check the status, order, and front-end display results of each chapter individually.

Actions such as “publishing”, “scheduled publishing”, “deactivating” or “deleting” will directly change the status of the chapter or its data. Please ensure that you have carefully selected the chapter you wish to modify. Deletion is an irreversible operation; therefore, it is recommended to keep copies of important chapters before performing this action.

Edit book chapters

![Chapter editing page for books]](/resources/image/2026/09/04/845266742001733.jpg)

The chapter editing page opens in a separate window. In the upper right corner of the page, the book to which it belongs and the current chapter status are displayed. The main text area contains the chapter title and a rich text editor:

  • Chapter TitleCode identifiers, version numbers, digits, and original meanings should be retained.
  • Chapter Text: Required. You can adjust settings such as bold font, italic font, underline, quotation marks, text color, first-line indent, line spacing, paragraph format, and font size. Additionally, you can insert links, third-party videos, materials, separators, and tables. The editor displays the number of paragraphs available for editing; the maximum number of paragraphs is 10,000.
  • SaveSave the current title and text, but do not change it to the published status.
  • Scheduled PublishingAfter selecting the scheduled release time, the item will enter the pending release state. If there are any changes to the text that need to be saved before proceeding with the scheduled release, the system will save those changes first before executing the actual release process.
  • Publish nowSave any unsubmitted changes and publish the chapter immediately.
  • Close: There will be a confirmation prompt when changes are not saved, to prevent the loss of content due to accidental closure of the page.

After editing, return to the book's "section list". Refresh the list and confirm that the section titles, status, and publishing times are as expected. Then preview the content and layout of the sections from the front end.

Save, review, and publish.

  1. Fill in the title, specific details related to the type, and all necessary basic attributes.
  2. Click "Save" to create a draft. Books must complete this step before they can be maintained in their chapters.
  3. Click “Preview” to check the page template, media playback, file download, links, and mobile layout settings.
  4. When the workflow is enabled for categories, click "Submit for Review". If the workflow is not enabled but you have publishing permissions, you can proceed to the pending status or publish directly according to the buttons displayed on the page.
  5. After publication, verify the results again from the content list or the front-page page.

Instead of clicking the “Close” button, try using browser back functions or simply closing the page. If the system indicates that there are unsaved changes before you leave the page, make sure to decide whether to save those changes or not.

FAQ

  • Error in content type selection: When the editing page is closed without saving any changes, it is recommended to create a new entry. For content that has already been saved, it is not advisable to change its type directly. Instead, it’s better to create an entry of the correct type and then migrate the existing content there.
  • **The media cannot be selected.**First, upload the appropriate types of resources in Resource Management. Also, check the file type, size limitations, and resource permissions.
  • **There is a save button, but no publish button.**The category may have an approval process enabled, or the current account only has permission to add and edit items.
  • **The list of book chapters is not available.**First, save the main content of the book. After generating the content records, then proceed to maintain the chapters.
  • **The third-party video front end does not display.**Check whether the shared code is complete, its source code allows embedding, and there are no restrictions due to CSP settings, template filtering, or HTTPS-related mixed-content policies in the site.
  • **The front-end style does not match the editor.**Check the generated template output, the publishing channel styles, template CSS, the cache, and the statically published pages.

On this page