> For the complete documentation index, see [llms.txt](https://docs.morpht.com/convivial-for-govcms/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpht.com/convivial-for-govcms/content-editing/editing-a-page.md). # Editing a page Open a page and choose **Edit** in the tabs under its title, or use **Edit** from the content list. The form has a main column split into **Content** and **Metadata** tabs, and a sidebar for publishing, menu and URL settings. All content types share the same layout, so once you know the Page form you know them all. See a test page on the demo site: ![The edit form](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-2740cf8776f504aca6035d115ddea4791d410230%2Fpage-form.png?alt=media) ## Content tab **Title** (required) — the page heading, used in the browser tab, menus, breadcrumbs and search results. **Last updated** — shown to visitors. Set it when you make a substantive change; leave it alone for typo fixes. **Description** (required) — one or two sentences shown in teasers, cards and search results, and used as the meta description. Write it for someone deciding whether to click. **Thumbnail** — the image used when the page appears in a card or list. Choose an existing image with **Add media** or upload a new one. **Icon** — the name of a [Phosphor](https://phosphoricons.com) icon, e.g. `file`. Used in some list styles; see [Icons](/convivial-for-govcms/theme-settings/icons.md). **Header** — collapsed by default. Open it to control the banner at the top of the page. See a customised header on the demo site: ![The Header group](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-be5db3a34e4159c66a0d81554169489b254c8cc0%2Fpage-form-header.png?alt=media) * **Introduction** — a short lead paragraph shown in the header, larger than body text. * **Banner palette** — the colour scheme for the banner: *Standard*, *Alternate*, *Primary*, *Secondary*, *Accent* or *Neutral*. See [Palettes](/convivial-for-govcms/concepts-and-tools/palettes.md). * **Banner title** — overrides the page title in the banner only. * **Banner image** — a content image displayed beside the title. * **Banner background** and **Banner background pan and zoom** — a full-width background image with an optional slow animation. Use either a banner image or a background, not both. * **Featured title** and **Featured links** — a short list of links shown in the banner, for the two or three things most visitors come for. **On this page** — set to *Standard* to show a table of contents built from the page's headings. See [On this page](/convivial-for-govcms/concepts-and-tools/on-this-page.md). **Content** — the main body. See [WYSIWYG](/convivial-for-govcms/content-editing/wysiwyg.md). **Components** — structured blocks placed below the body. See [Components](/convivial-for-govcms/content-editing/components.md). **Attachments** — documents for download, listed at the end of the page. ## Metadata tab ![The Metadata tab](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-feab7bc94b1b3c9590570af36f264cd358dfb691%2Fpage-form-metadata.png?alt=media) These fields are optional but improve findability and let the site report on its content: * **Review by** — the date the content should be checked. Drives the review lists on the user dashboard. * **Owner** — the business unit responsible for the page. * **Stage**, **Goal**, **Intent**, **Intents satisfied** — classification used by [personalisation](/convivial-for-govcms/concepts-and-tools/personalisation.md) and analytics. Follow your site's content model; leave empty if unsure. * **Same as** — a URL that identifies the subject of the page (e.g. a Wikipedia page). Helps search engines and AI assistants understand the content. * **Type** — a Schema.org page type. Set to *FAQPage* for FAQ pages; otherwise leave empty. ## Sidebar ![The sidebar](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-4e94cd60146286768b2cf9095558fc78ad4a2933%2Fpage-form-sidebar.png?alt=media) **Revision log message** — a short note on what you changed. It appears in the revision history, so write it for a colleague looking back in six months. **Current state / Change to** — the editorial workflow. See [Workflow](/convivial-for-govcms/content-editing/workflow.md). **Menu settings**, **URL alias**, **URL redirects** and **Meta tags** are covered below. **Hide** — hides parts of the page layout: *Header*, *Breadcrumb*, *Heading*, *Introduction*, *Sidebar*, *Meta*, *Properties*, *Container*, *Print* and *Listen*. Useful for landing pages built entirely from components. See [Hiding content](/convivial-for-govcms/concepts-and-tools/hiding-content.md). **Search exclude** and **Simple XML sitemap** — leave at their defaults unless the page should not be discoverable. See [Excluding from search](/convivial-for-govcms/concepts-and-tools/excluding-from-search.md). ## Preview and save **Preview** shows the page as visitors will see it without saving. **Save** stores a new revision in the state chosen under **Change to**. Saving never publishes on its own. ![Preview and save](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-361ab158b4a0318c9279627c3a506a94e1c921c4%2Fpage-preview.png?alt=media) ![The published page](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-15792fad1d88b90a0ef69992a957fa6d697e61d7%2Fpage-front.png?alt=media) ## Embed media To place an image, document or video inside the **Content** field, put the cursor where it should go and click **Insert Media** in the editor toolbar. ![The Insert Media button](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-1052705f8a0de9a9d6351fafe9e16969b15cafd5%2Fwysiwyg-media.png?alt=media) The media library opens. Use the tabs on the left to switch between **Image**, **Document**, **Remote video** and the other types, search or filter, tick the item and click **Insert selected**. The **Add file** field at the top of each tab uploads a new item without leaving the page; the **Remote video** tab accepts a YouTube or Vimeo URL. ![The media library](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-9d3f6a0b0efa89b54124aabe1bd01092900b7da2%2Fwysiwyg-media-library.png?alt=media) Once inserted, click the image to choose its alignment and whether to show a caption. ## Menu Open **Menu settings** in the sidebar, tick **Provide a menu link**, and choose a **Parent link**. The URL alias is generated from the menu position, so set the parent before saving for the first time. ![Menu settings](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-88411bb4246b3b76772678110d11f9898bbb3de7%2Fpage-form-menu.png?alt=media) To reorder or restructure the whole menu, see [Navigation](/convivial-for-govcms/site-structure/navigation.md). ## Meta tags The important meta tags — title, description, image — are generated automatically from the **Title**, **Description** and **Thumbnail**, so make sure every page has a Description. Open **Meta tags** in the sidebar only when a page needs a specific override. ![Meta tags](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-2ced4d6b89fcbfe5bb883ffd77189b1d4bd77865%2Fpage-form-meta-tags.png?alt=media) ## URL alias Addresses are generated automatically from the title and menu position, e.g. `/services/permits/apply`. To set a specific address, open **URL alias** in the sidebar, untick **Generate automatic URL alias** and type it. Keep addresses lowercase, with hyphens between words. ![URL alias](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-57af7799d496d56175c56e6af2a9fe53db56cfa4%2Fpage-form-alias.png?alt=media) Changing a page's title or moving it in the menu changes its address. The old address is **not** redirected automatically — add a redirect so existing links keep working. ## URL redirects To send an old or short address to a page, open **URL redirects** in the page's sidebar and add the path. ![URL redirects on the page form](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-0b4fc1923f9060f3b4e5f750c89051fe26adcd75%2Fpage-form-redirects.png?alt=media) To manage every redirect on the site go to *Manage → Configuration → Search and metadata → URL redirects* (`/admin/config/search/redirect`). ![Managing redirects](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-dcd77201f7a5059a6832986d79edba7fc86a775c%2Fredirects.png?alt=media) Click **Add redirect**, enter the **Path** to redirect from and the page or URL to redirect **To**. For an external destination include the full address with `https://`. ![Adding a redirect](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-65effce93fc037434616a868c75534e46072c510%2Fredirect-add.png?alt=media) Add a redirect whenever you archive a page that others may have linked to, pointing it at the closest replacement. ## Revisions Every save creates a revision. Open **Revisions** in the tabs under the page title to see the history with each revision log message. **Compare** shows the difference between two revisions; **Revert** (Approvers) makes an earlier revision the current one — as a new revision, so nothing is lost. ![Revision history](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-72368659ee19c52b469170cec993eb62d1df8298%2Frevisions.png?alt=media) ## Delete content Authors and Approvers cannot delete content. Prefer archiving (see [Workflow](/convivial-for-govcms/content-editing/workflow.md)): an archived page can be restored, and its address can be redirected. If a page must be deleted, ask a Site administrator — the **Delete** action is under **More actions** on the edit form. ![Delete under More actions](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-b52606cdc551433eadee6acef708fd9b4e06c202%2Fpage-delete.png?alt=media)