Using the CMS

The plain-language guide to writing and publishing content. No technical knowledge needed.

/admin — on this same domain

That address is the content management system (CMS). It only manages content — the public website is built separately and reads from it.

Logging in

Enter your email and password at /admin. Forgot your password? Click Forgot password? and you'll get a reset link by email.

Locked out? After 5 wrong attempts your account locks for 10 minutes. Wait it out, or ask an admin to unlock you.

Writing a blog post

  1. In the left sidebar, click Posts, then Create New.
  2. Give it a title. The slug — the post's web address, like /blog/my-post — fills in automatically from the title. Edit it if you want something shorter.
  3. Write in the Content area. The toolbar has headings, bold, lists, links, quotes, and images. The + button (or typing /) inserts blocks.
  4. Optionally add a cover image, a short excerpt (shown in post listings), and tags — pick existing ones or create new ones right in the field.
  5. Finish with one of two buttons:
    • Save Draft — saved, but invisible to the public.
    • Publish — live on the site. The publish date sets itself the first time; you can change or backdate it in the sidebar.

Want a post highlighted on the homepage or the top of listings? Tick Featured in the sidebar.

The other content types

They all work like posts, with small differences:

TypeWhat it's for
PagesOne-off pages such as About or Contact.
ProjectsPortfolio items; can carry a live link and a downloadable file.
ServicesService offerings.
ResourcesLinks or downloads (e.g. templates) — fill the external URL, attach a file, or both.
TagsThe shared label list. Usually managed from inside a tag field, but here you can rename or delete tags — renames apply everywhere at once.

Images and files

All uploads live in Media. Anything you upload inside a post lands there too, and can be reused anywhere.

Images ask for alt text: a one-line description used by screen readers and search engines. Documents like PDFs don't need it.

Careful with delete. Removing a media item removes it everywhere it's used — the CMS warns you if something still references it.

Your profile

Click Users → your account. Fill in your first and last name (your author byline on the site), a profile picture, an About the author bio, and your personal social links.

The small picture in the admin's top-right corner is separate — it comes from gravatar.com for your login email. Set a photo there if you want it.

Site-wide settings (admins only)

Under Globals in the sidebar:

  • Global — site name, tagline, default description, logo, favicon, the default social-share image, and the site's own social links.
  • Permalinks — the URL prefix for each content type (e.g. posts under /blog). Changing these changes the public addresses of existing content, so edit with care.

Roles

RoleCan do
AdminEverything: manage users, change settings, edit all content.
EditorManage content and their own profile. Can't see other accounts, change settings, or change roles.

The CMS protects itself from lock-outs: the first account ever created is an admin, and the last remaining admin can't be deleted or demoted.

Publishing and the live site

Publishing here makes content available to the website. Depending on how the site is set up, changes appear live within a few minutes.

This guide ships with the CMS blueprint — the same text lives in the project as EDITORS.md.