A Symphony project’s Workspace is a directory that contains all project-specific files. By default, the workspace will store data sources, events, pages, utilities, and any files that are uploaded via fields in an entry. Often, developers will use the workspace directory to store other assets as well, such as CSS and JavaScript files or template images.


As long as the default subdirectories are left intact, users are free to create any desired directory structure within the workspace folder.

A workspace’s URL is included as a system parameter by Symphony.


By default, the system will create and use four subdirectories within the workspace:


Physical files representing each of the above elements are stored here and can be edited directly in lieu of using the admin interface’s editors.

Additional subdirectories can be created as needed. Common practices include creating directories for assets (like /styles, /images, and /scripts) and an /uploads folder to serve as a target for file upload fields.

The Big Picture

A Symphony project’s workspace contains all of the files that make it unique from other Symphony builds. A “clean” Symphony install contains no workspace—an empty one is generated during installation. The workspace folder is included when creating ensembles.

File upload fields must choose folders in workspace/ as their target.

Symphony • Open Source XSLT CMS

Server Requirements

  • PHP 5.3-5.6 or 7.0-7.3
  • PHP's LibXML module, with the XSLT extension enabled (--with-xsl)
  • MySQL 5.5 or above
  • An Apache or Litespeed webserver
  • Apache's mod_rewrite module or equivalent

Compatible Hosts

Sign in

Login details