Browse · Help archive
Getting Started
Account & Security
Billing & Plans
Organization & Roles
QA-QC
Project Matrix
File Management
Project Members
Access Requests
Project Setup
Attribute Extract
Attribute Import
Scheduled Jobs
Power BI Analytics
Foreman Assistant
Permissions Graph

Draft · This article is being updated. Content may change.

  1. Archive
  2. /
  3. Project Matrix
  4. /
  5. Folder Structure & Deployment

Folder Structure & Deployment

Define and deploy folder hierarchies to ACC projects from your matrix.

Step 4 — Folder Structure

The Folder Structure step lets you design folder templates that automatically expand into a full project folder hierarchy using your matrix values. Templates use placeholder tokens that are replaced with actual party and discipline names.

Template placeholders

Templates are entered as text with segments separated by /. Two placeholder tokens are available:

Token Expands to
XXX Each Level 1 (Party) value — one folder per party.
YYY Each Level 3 (Discipline) value — one folder per discipline.

For example, the template Documents / XXX / YYY with parties [Employer, Contractor] and disciplines [Civil, MEP] would produce:

Documents / Employer / Civil
Documents / Employer / MEP
Documents / Contractor / Civil
Documents / Contractor / MEP

Expansion toggles

Three toggles control how templates expand:

  • Use display namesXXX expands using display names from Step 3 instead of raw party codes.
  • Use overridesYYY expands using per-party restrictions from Step 2, so each party only gets sub-folders for its allowed disciplines.
  • Use role group folders — Additional folders are generated for role group values (e.g., an "All" folder alongside individual discipline folders).

Folder editing

Once templates are expanded, you can:

  • Rename folders — Click a folder name to edit it inline. Renames are tracked separately so the original template is preserved.
  • Exclude folders — Mark folders for exclusion (shown with strikethrough). Excluded folders are skipped during deployment. You can restore them individually or all at once.

The FolderTreePreview panel shows a hierarchical view of all expanded paths with expand/collapse controls, giving you a visual check before deploying.

AI folder suggestions

Click Suggest Folders to generate templates based on standards like ISO 19650 or PAS 1192. The AI produces CDE status folder templates (WIP, Shared, Published, Archive) tailored to your matrix values. You review with checkboxes and choose to replace or add to your existing templates.

Import from ACC

You can import an existing folder structure from the ACC project. Choose a depth level (1-4 or all), optionally tick "Also import folder permissions", and click Fetch. The result appears as a tree with checkboxes — select the folders you want to import. Existing permissions are mapped to standardised permission levels.

Folder deployment

Deployment creates the expanded folder structure in ACC. It is non-destructive — existing folders are left in place, and only missing folders are created. Each folder is created with retry logic to handle transient API failures. Progress is shown in real time.

Folder deployment does not delete existing folders. If you rename a folder in your template, the old folder remains in ACC and a new one is created alongside it.

You're offline — some actions may not work.

Connection lost

Attempting to reconnect to Foreman...

Connection lost

Retrying in --s Attempt - of -

Connection interrupted

Retrying in --s Attempt - of -