Skip to main content

Projects Collection — Content Reference

CMS Path: Projects Collections

Folder: content/projects/

Each project is an individual Markdown file in content/projects/. The Projects Page lists them all.

python ssg pro jamstack static site generator

What Is a Project Entry?​

A project entry represents a single portfolio item — a case study, a client project, a piece of work.

Each entry has:

  • Metadata (title, client, year, etc.)
  • A featured image
  • A full body (Markdown)

Project Fields​

FieldFile KeyWhat It Controls
LayoutlayoutTemplate used (do not change)
InfoinfoShort category label (e.g., "Architecture System")
TitletitleProject name
DescriptiondescriptionShort summary for listings and SEO
ImageimageFeatured image
ClientclientClient name
YearsyearsProject year
DatedatePublish date (used for sorting)
TagstagsList of tags
AuthorauthorAuthor name
BodybodyFull project content in Markdown

Field Details​

Info​

A short label that appears above the project title. Use it to categorize:

  • "Architecture System"
  • "SaaS Platform"
  • "Corporate Identity"
  • "Brand Campaign"

Title​

The project name. Keep it clear and descriptive.

Description​

A one- or two-sentence summary. Used in:

  • Project listings
  • Meta description for SEO
  • Social shares

Image​

The featured image for the project. Recommended:

  • Format: AVIF or WebP
  • Size: 1200×800 or 1600×900
  • File size: Under 200 KB

Client​

The client or organization the project was for.

Years​

The year the project was completed or delivered. Displayed as a string (e.g., "2026").

Date​

The publish date. Used for sorting. Format: YYYY-MM-DD.

Tags​

A list of tags. Used for:

  • Related projects
  • Tag pages (auto-generated)
  • Filtering

Body​

The full project content in Markdown. This is where the case study lives — challenge, approach, result, images, quotes.

python ssg pro jamstack static site generator

How to Create a New Project​

  1. Open the CMS at /admin/

  2. Click Projects Collections in the sidebar

  3. Click New Projects Collections at the top

  4. Fill in all fields:

    • Info
    • Title
    • Description
    • Image
    • Client
    • Years
    • Date
    • Tags
    • Author
    • Body

  5. Click Save

The project is saved as a Markdown file in content/projects/. It appears in the Projects listing after the next build.

How to Edit a Project​

  1. Click Projects Collections
  2. Click the project title in the list
  3. Edit any field
  4. Click Save

How to Delete a Project​

  1. Open the project
  2. Click the three-dot menu at the top right
  3. Click Delete entry
  4. Confirm

File Naming​

Decap CMS uses the Title field to generate the file name (slug). For example:

TitleFile Name
"Project 01 — Modular Architecture"project-01-modular-architecture.md
"Zetta Consulting Profile"zetta-consulting-profile.md

You can override the slug if needed by editing the file name manually in Git.

Recommended Body Structure​

A strong project body usually follows this structure:

  1. The Challenge — what problem the client had
  2. The Approach — what you did
  3. The Result — what happened, with numbers if possible
  4. Key Details — tech stack, timeline, team
  5. Gallery — screenshots, photos, mockups

Use headings (##) to break it into scannable sections.

Best Practices​

  • Lead with the result — the strongest projects start with impact
  • Use real clients and numbers — vague case studies do not convert
  • Add images — visual proof beats text
  • Keep descriptions short — 1–2 sentences, not paragraphs
  • Use consistent tags — helps related projects
  • Date accurately — used for sorting

Troubleshooting​

Project does not appear in the listing​

  1. Check that the file exists in content/projects/
  2. Confirm the frontmatter is valid YAML
  3. Check that the date field is filled in
  4. Rebuild the site

Image does not display​

  1. Confirm the image path starts with /img/
  2. Check that the file exists in static/img/
  3. Verify the image widget saved correctly

Tags do not create tag pages​

  1. Confirm tags has at least one item
  2. Check that the tag pages are generated in output/tags/
  3. Rebuild the site

Body content does not appear​

  1. Check the Body field is not empty
  2. Confirm the Markdown syntax is valid
  3. Rebuild the site

Slug is wrong​

Decap CMS generates the slug from the Title. To customize:

  1. Rename the file manually in Git
  2. Or change the Title to influence the slug

What's Next?​

Now let's look at Blog Posts.

👉 Next: Blog Posts →