Craft CMS

Craft CMS

What is Craft CMS?

Craft CMS is the content management system (CMS) that powers this site. This site runs on Craft 5.

Documentation

See the Craft 5 Documentation for more about the core concepts described below.

Entries

What are entries?

Entries hold the content that appears on web pages — the homepage, a blog post, a contact page, and so on. Entries belong to sections and use fields to store their content.

What are sections?

Sections organize entries. There are three types:

What are fields?

Fields store content — a text field, an image field, a dropdown, and so on. Each entry shows a particular set of fields based on its entry type. Many pages use a Modules field to build the page out of reusable blocks (see the “Rebar Module System” page).

How do I edit an entry?

Go to Entries in the CP sidebar, find the entry, and click its title. Edit the fields using the labels and instructions as your guide, then click Save (top right).

How do I create a new entry?

Go to Entries, choose the section in the sidebar (a single, channel, or structure), and click New entry. Fill out the fields and click Save.

How do I save a draft?

While editing, entries autosave as a draft as you work. To create a named draft, use the Drafts menu near the entry title and choose Create a draft.

How do I preview an entry or a draft?

Use the Preview or Share button near the top of the edit screen. Share gives you a link you can send to someone who isn’t logged in.

How do I see or restore an earlier version of an entry?

Craft keeps a history of saved Revisions. Open the revision menu near the entry title, choose a revision to view it, and use Revert entry to this revision to restore it. (In older Craft these were called “versions.”)


Modules

What are modules?

Modules are the building blocks of page content — text, images, videos, banners, and so on. You enter the content and it is formatted automatically. Modules can be added, removed, edited, and reordered at any time on the entry’s edit page. See the “Rebar Module System” page and the “Modules: Advanced Options” page for details.

Where are the modules on an entry?

Open the entry and find the Modules field (it may be on its own tab). Every module on the page is listed there in order.

How do I add a module?

In the Modules field, click + Add (or New entry) at the bottom and choose the module type. A new block appears with its fields; fill them in and Save.

How do I remove a module?

Open the module’s actions menu (the ••• / gear at the top of the block) and choose Delete, then Save.

How do I reorder modules?

Drag a module by its move handle into its new position. Collapsing modules first (see below) makes long pages easier to reorder.

How do I expand or collapse modules while editing?

Use the module’s actions menu to Collapse or Expand, or double-click a module’s title bar to toggle it.


Assets

What are assets?

Assets are the files, images, and documents stored in Craft.

How do I browse assets?

Go to Assets in the sidebar. Choose a volume/folder to see the files inside it.

How do I preview a single asset?

Double-click an asset to open it, or use the asset’s actions to View. (If a “view” link isn’t available for a volume, it may not be publicly served.)

How do I replace an asset?

Find the asset, open its actions menu, and choose Replace file. Keeping the same filename means every place that references the asset updates automatically. See also the “Content Entry Tips” page.

How do I edit an asset’s details?

Double-click the asset to open it, edit its fields (title, alt text, focal point, etc.), and Save.

How do I upload several assets at once?

Open the target volume/folder and drag the files into the window, or use the Upload button.


Categories

What are categories?

Categories are entry-like elements used to classify Assets, Entries, Users, and other elements. Categories always belong to a category group.

What are category groups?

Category groups are logical groupings of categories. They are set up by development and shouldn’t be created ad hoc.

How do I see and edit categories?

Go to Categories, choose a group, and click a category’s title to edit it. Use New category to add one to a group.

Is it safe to delete a category?

If you created the category, it’s generally safe to delete. Categories that have existed since launch may be referenced in important places — delete those only if you’re sure.


Users

What are users?

Users are the accounts that can sign in to Craft.

How do I manage users?

Go to Users. Click a user to edit their profile and Permissions (on the Permissions tab). Use New user to invite someone — Craft emails them a link to set a password.

Should everyone be an admin?

No. Admins can change anything, including other users and site settings. Grant the narrowest permissions that let someone do their job, and reserve admin for those who truly need it.

How do I suspend or remove a user?

Select the user, open the actions menu, and choose Suspend or Delete. When deleting, Craft lets you transfer that user’s content to another user.


Globals

What are globals?

Globals are pieces of content available on every page — for example the utility bar, navigation, and footer. Edit them under Globals in the sidebar.