Every file uploaded to the CMS becomes part of the repository. A badly named file is permanent — it can't be renamed after upload without breaking any page that references it. Name files correctly before uploading.
The Three Rules
1. Lowercase only
All filenames must be entirely lowercase. Uppercase letters cause inconsistent behaviour across different systems and hosting environments.
| Wrong | Right |
|---|---|
Matt-Neagle.jpg |
matt-neagle.jpg |
About-Page-Hero.webp |
about-page-hero.webp |
Hayley_Davis_Profile Image.jpg |
hayley-davis-profile.jpg |
2. Hyphens instead of spaces
Never use spaces in filenames. A space becomes %20 in a URL, which is ugly and error-prone. Use a hyphen (-) wherever you would use a space.
| Wrong | Right |
|---|---|
team matt neagle.jpg |
team-matt-neagle.jpg |
Singapore International Racing.jpg |
singapore-international-racing.jpg |
Grandstand sign.jpeg |
grandstand-sign.jpeg |
3. No special characters
Avoid underscores, brackets, ampersands, apostrophes, commas, or any character that isn't a letter, number, or hyphen.
| Wrong | Right |
|---|---|
kevin_naughton_profile.jpg |
kevin-naughton-profile.jpg |
matt&kevin-singapore.jpg |
matt-kevin-singapore.jpg |
image (1).png |
image-1.png |
Copy of photo.jpg |
descriptive name, see below |
Rename before uploading
The CMS media library does not allow renaming after upload. If a file is uploaded with the wrong name, it must be deleted and re-uploaded — and any page that used the old path will show a broken image until manually updated.
Naming Patterns
Good filenames describe what the image contains and where it is used. Follow these patterns for each file type.
Team profile photos
team-[firstname]-[lastname]-[variant].webp
| Example | Usage |
|---|---|
team-matt-neagle-portrait.webp |
Profile card and team page |
team-kevin-naughton-portrait.webp |
Profile card and team page |
team-hayley-davis-profile.jpg |
Newly uploaded profile photo |
Use portrait for formal headshots and profile for more casual images.
About page images
about-[section]-[description].webp
| Example | Usage |
|---|---|
about-hero-banner-victoriasq.webp |
Hero section background |
about-founder-matt-neagle.webp |
Founder bio portrait |
about-diplomaticengagement-mattneagle-erikaolson.webp |
Mosaic section |
News article images
news-[year]-[slug]-[descriptor].webp
| Example | Usage |
|---|---|
news-2026-political-powerhouse-hero.webp |
Article hero image |
news-2026-defence-forum-panel.jpg |
Inline article photo |
Case study images
case-[client-slug]-[descriptor].webp
| Example | Usage |
|---|---|
case-diarkis-team.webp |
Case study hero |
case-sa-water-project.jpg |
Case study inline image |
General uploads and gallery photos
[context]-[description]-[optional-name].jpg
| Example | Usage |
|---|---|
singapore-international-racing.jpg |
Event photo |
election-1993-hepworth-antony-green.jpg |
Historical photo |
kn-singapore-luncheon.jpg |
Kevin Naughton Singapore trip |
adviser-sa-premier-golf.png |
SA Premier adviser photo |
Be descriptive, not cryptic
260507_NorthAdelaideGolf-AustralianOpen-5.PNG tells the system nothing useful and breaks every rule. The same photo renamed to adviser-sa-premier-north-adelaide-golf.png is searchable, readable, and future-proof.
Documents (PDF, DOCX)
[type]-[title-slug]-[year].pdf
| Example | Usage |
|---|---|
proposal-ace-strategies-platform-2026.pdf |
Client proposal |
report-iaa-market-intelligence-q1-2026.pdf |
Member briefing |
policy-code-of-conduct-2026.pdf |
Legal document |
File Formats
Use the right format for the right purpose — format affects file size and quality.
| Format | Use for | Avoid for |
|---|---|---|
| WebP | All photos and hero images | Logos with transparency |
| JPG / JPEG | Photos when WebP is not available | Screenshots, diagrams |
| PNG | Screenshots, diagrams, logos with transparency | Large photos |
| SVG | Logos, icons | Photos |
| Documents for download | Images |
WebP is preferred
WebP files are 25–35% smaller than JPG at the same quality. Where possible, convert photos to WebP before uploading using a free tool like Squoosh or CloudConvert.
Before You Upload — Checklist
- [ ] Filename is entirely lowercase
- [ ] Words separated by hyphens, not spaces or underscores
- [ ] No special characters (
_,(,),&,',,) - [ ] Name describes the content and context of the file
- [ ] No "Copy of", "image (1)", or camera-generated names (e.g.
IMG_4821.jpg) - [ ] File format matches the use case (WebP for photos)
- [ ] File size is reasonable — photos under 500 KB, hero images under 1 MB
Quick Reference
✅ team-hayley-davis-portrait.webp
✅ about-hero-banner-victoriasq.webp
✅ news-2026-defence-forum-hero.jpg
✅ case-diarkis-team-photo.webp
✅ proposal-ace-platform-2026.pdf
❌ Hayley Davis_Profile Image.jpg
❌ About Page HERO (final).png
❌ Singapore International Racing .JPG
❌ Copy of Matt photo (2).jpg
❌ IMG_4821.JPG