Learn

Folder Tour

Take a walk through the wonderful world of Statamic.

Statamic’s base folder structure looks like this:

_add-ons/
_app/
_cache/
_config/
_content/
_logs/
_themes/
admin/
assets/
admin.php
index.php

What Each Folder Does

  • _add-ons is where you keep add-ons that you want to use in Statamic. Installing an add-on is simply a matter of dropping the add-on folder into your _add-ons folder.
  • _app is where all of our core files are kept. You shouldn’t need to touch anything in here.
  • _cache is where Statamic’s core and other add-ons can store files for data management. You probably don’t need to touch anything in this folder either, the system will do that for you.
  • _config is where you configure Statamic and set global variables.
  • _content is where all of your content files are. Simple as that.
  • _logs is where messages are logged to by default. This can be changed in your configuration.
  • _themes is where you’ll put the files defining how your site looks and feels. If you’re using a theme that someone else made, you would drop their theme folder in this folder.
  • admin holds all of the Control Panel files. If you don’t want to use the Control Panel, you can delete this folder.
  • assets is where we recommend putting site images, scripts, and downloadable files, but this folder isn’t used by system files at all. Just a helper to get you started.

What Each File Does

  • admin.php powers the Control Panel. If you don’t want to use the Control Panel, you can delete this file as well.
  • index.php powers the public-facing part of your site. You shouldn’t need to touch this file, but it needs to be there.

This article was last updated on March 30th, 2016. Find an error? Please let us know!