Permalink
Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
78 lines (58 sloc) 3.57 KB
title id overview content_types parse_content
Content Types
4076fea7-63c9-4b1c-b16d-7eb565040d81
All content is stored in one of six content types. They all share a common data format (YAML/Markdown files), but each has <span class="highlight">unique characteristics</span> to optimize and simplify the way you manage the content. For example, Pages automatically generate Navigation and Globals are made available in all of your templates.
eca58f56-9d97-40f8-9df0-b61b92e29722
9e4bd6e1-0b91-42bc-92df-610ec6dbf3f4
e8092f11-c3b4-477a-a3a4-9c5e65f45cc4
30955bc8-9c14-4523-858f-01c308b50d63
28bf911b-8f47-489b-8040-37607733b270
d744ff59-3507-419d-9808-84079d8111a4
true

Overview {#overview}

All of your site's content -- everything created, edited, uploaded, published, and available to display somewhere on your site, lives in one of Statamic's six Content Types:

  1. Pages
  2. Collections
  3. Globals
  4. Taxonomies
  5. Assets
  6. Users

The Lingo (container and child names) {#lingo}

Each content type is a container for any number of items. For instance, you can create any number of Collections -- each with its own name, purpose, and data structure -- that contain an unlimited number of Entries. This "belongs to" pattern exists in each Content Type, not unlike SAT Analogy Questions. Do you remember those? They were super annoying.

The individual items in each Content Type are (in most cases) represented by content files in a YAML Front-Loaded format. Each container and corresponding child type has their own pair of labels.

Content Type Child Type
Pages Page
Collection Entry
Global Set
Taxonomy Term
Asset Container Asset
Users User

Each Content Type has this stuff in common {#shared-attributes}

Content Types are defined by their differences, but they share a whole lot of features and attributes. Let's cover these first because they're pretty important -- and useful.

Custom Fields

The primary attribute that defines a Content Type is the ability to configure any number of Custom Fields (in a group called a fieldset) to model and structure your content however you see fit. Whether you want one giant text field or a hundred little granular fields and options, you're doing it right.

Unique IDs {#ids}

Each content type has it's own method of ensure "uniqueness", which lets you create relationships or simply fetch content by ID. Here are a couple of examples of how this is useful:

  • Relate a User with an Entry, thereby creating an author.
  • Relate a list of Entries with another Entry establishing related articles.
  • Relate a group of Assets with a Entry, creating a gallery.

The Types {#list}

Now let's explore the differences between Content Types. Each has a distinct purpose and ability that makes them a hero in the world of content management.

{{ relate:content_types }} {{ /relate:content_types }}