Create or edit a page, post or custom content item
A content item is one entry of a content type: a blog post, an event, a product. This page shows how to create one, keep working on it privately, publish it, and change its address or template.
Note Designed pages such as Home and About are site pages, not content items. They are built from widgets; see Site pages and the page builder. Everything below is for content types such as Posts.
What you need
- A content type with at least one field (every new type has Title and Content).
- Edit permission on that content type, which an administrator grants on the role.
Create an item
- In the sidebar, click the content type under Content types, for example Posts. You land on its list.
- Click New Post (the button always reads New plus the singular label).
- Fill in the fields on the left. The Title is the primary field and names the item.
- Choose a Template. It decides how the item's public page looks. The list offers the templates the content type may use, and the first one is a safe choice.
- Click Publish to make it live, or Save draft to keep it private.
After saving, you are on the item's editor. Raytha gave the item a web address from the content type's default route template, for example posts/my-first-post.
The rich text editor
Wysiwyg fields use a toolbar editor. It offers undo and redo, headings (levels 1 to 4), bullet, numbered and task lists, block quote, code block, bold, italic, strikethrough, inline code, underline, highlight, links, superscript and subscript, text alignment (left, center, right, justify), Image and File uploads, and search and replace. Uploaded images and files are stored in the media library.
Other field controls
- Date fields take a date in the form
YYYY-MM-DD. - Attachment fields upload a file and then show a Current file link. Clear removes it.
- One to one relationship fields have a Search related items box and a Clear button.
- Dropdown fields start on Select….
Draft or publish?
| Button | What happens |
|---|---|
| Save draft | Saves your edits as a draft. Visitors keep seeing the last published version. A new item saved this way is not visible at all. Required fields may be empty. |
| Publish | Checks required fields, replaces the live version with your edits, and keeps the previous live version as a revision. |
| Unpublish | Takes the item off the public site. It stays in the admin. Shown only when the item is published. |
| Discard draft | Throws away unpublished edits and goes back to the published version. Shown only when a draft exists. |
The editor shows what you are looking at: when a draft exists, the form loads the draft; otherwise it loads the published content. The Status card on the right shows a Published or Unpublished badge, a Draft badge when there are unpublished edits, and when the item was last updated.
There is no scheduled publishing. You publish when you are ready. For revisions, reverting and the details of drafts, see Revisions and publishing.
Preview and view live
- Preview in the page header opens the public page with your draft applied. Only admins who can edit the content type see a draft preview; everyone else gets a "not found" page for unpublished items.
- View live opens the published page. It appears only when the item is published.
Change the route path or template
On the right of the editor, the Settings card holds two settings that apply to the item immediately, without publishing:
- Edit Route path. This is the web address after your domain, with no leading slash.
- Change Template if you want a different public layout.
- Click Save settings. You should see "Settings saved".
Route path rules: letters, numbers and hyphens are made URL-friendly automatically; at most 200 characters; no ..; dots only in the last segment; it cannot start with a reserved path such as raytha; and it must not already belong to another page, view or item ("The route path ... already exists").
Warning Changing the route path changes the item's public address. Old links to the previous address stop working, so update menus and links that point to it.
Delete an item
In the Delete item danger zone at the bottom of the editor, click the button and confirm. The item moves to the trash and can be restored; see Restore deleted content items. You cannot delete the item that is currently set as the home page.
Gotchas
- Saving a draft of a published item does not change the live site. Click Publish when you want visitors to see the change.
- Publish can fail on a required field. The message names the field; fill it in and publish again.
- The Template list can be empty or short. A template only appears if it is allowed for this content type (Content types that can use this template in the template's settings).
- A published item does not appear in a list unless the list's view is public and its filters let the item through. See Modify, create and publish a list view.