# Using the CMS | Foundation CMS docs

Source: https://swarmlabs.foundation/docs/editing

## Using the CMS

You'll find a site's admin at hq.<your domain>. Until the site has its own domain, it's at hq.<site>.foundationcms.org. Once you sign in, you stay signed in for 72 hours.

### Finding your way around

The rail on the far left lists the main sections. Click one and its menu opens in a second rail next to it. Dashboard and System health are the exceptions: they open full width.

SectionWhat you'll find there
DashboardVisits, recent changes, form submissions and anything that needs your attention.ContentAll the content types (pages, news and anything else this site's model defines), Taxonomy (the categories and tags entries are filed under), the field library, and Media, where images and files live.SiteNavigation menus, redirects, global content (values that appear on every page), forms, design (logo, colours, fonts), marketing, and scripts (tracking or chat code, each run only once a visitor has agreed to its kind of cookie).PeopleTeam is everyone who can sign in to this site, with their role. Members are visitor accounts, for sites that have them. They're kept apart because different rules apply to each.SettingsSite covers identity and branding, domains and publishing, email, spam protection, who can sign in from where, compliance, the business's details for search, and analytics and ads. CMS covers health checks, the activity log, users and roles, and API keys.System healthChecks on the address, the certificate, email DNS, menus, redirects and the database, plus recent errors.

### Writing and publishing

Open a content type and pick an entry. The fields come from the site's model, so the editor matches whatever that site holds. To save, use the button in the top bar or press ⌘S. An entry can be a draft, published, or scheduled to go live on a date.

Every save keeps a revision. If you delete an entry it goes to the bin, and you can restore it from there.

### Categories and tags

Content → Taxonomy holds the lists entries are filed under, one tab each: categories, which can nest; tags; and attributes, such as a list of features. One list can apply to more than one content type.

When you edit an entry, its categories and tags are in the pane on the right. The first one is the primary term: it decides the entry's breadcrumb and the label on its card, and MAKE PRIMARY moves another to the front. You can type a new tag as you write; categories are added on the Taxonomy screen.

In a content type's list you can filter by a term, or select several entries and use File under… to file them all at once. The pane beside the list shows the terms of the entry you're on.

A category or tag can have its own page on the site. On the Taxonomy screen each term has an introduction, an image, text for below the list, questions and answers, its search and sharing details, and whether search engines should list it. Change a term's address and the old one redirects to the new one. Delete a term that's in use and you're asked where its entries go: to another term, which merges the two, or nowhere.

### Media

Look for UPLOAD, or drag files onto a media field. Folders work like tags, so the same file can be in more than one. Use + NEW FOLDER to make a folder, and open one if you want to rename, move or remove it.

You write a file's alt text once and it's used everywhere the file appears. The description is a note for the library (who's in a photo, where it was taken), and search looks at it too.

### Menus

Site → Navigation shows the site's menus where they appear: the header across the top and the footer menus underneath. Click a link to rename it, move it or take it out. A link to a page uses the page's title unless you type a label of your own, and if the page is renamed the menu follows.

Click a header link to see its drop-down, which is a row of columns. There are four kinds of column: a list of links, a list that fills itself from a tag (your three newest posts, say, or every service tagged Popular), a short piece of text, and a card with a button. Add one with the buttons at the end of the row, then change it in the pane on the right. When you tag or untag an entry, any list that follows that tag updates by itself.

The dot beside each link tells you whether it works. A link to a draft page stays hidden until the page is published, and a link to a page that has been deleted is marked as broken.

### Forms

Forms are built under Site → Forms. You set the questions, sections and conditions, where submissions go (email or a webhook) and how long answers are kept. A question can be emailed only: its answer goes out in the email and is never saved with the submission, for anything sensitive.

Submissions land in the form's inbox. Each one shows when it came in, where from, and whether the email went through. Marking one as spam deletes it and blocks the sender.

### Search

Press ⌘K to search. It covers the title and text of every entry, and the admin's own screens.
