Naming All Files

Choosing a file name can be difficult. However, it is very important because renaming files destroys links and causes errors. To ensure consistency of file names, use

  • Lowercase letters only
  • Alphanumeric characters: a-z, 0-9 (no symbols)
  • Dashes between words (no spaces or underscores)
  • Descriptive words when naming content; precise file naming will create higher searchability and quicker indexing within Cascade

These guidelines apply to naming files as well as folders in Cascade. 

Good file names:

  • group-interest-form
  • james-madison-awards
  • campaign-goal-reached

Bad file names:

  • group-interest-form-2019 (avoid using dates in file names that will be updated yearly; instead, make the file name generic and update the same file rather than creating a new file every year)
  • James Madison Awards (Do NOT use capital letters or spaces)
  • campaign_goal_reached! (Do NOT use special symbols or underscores)

Naming Content Blocks

A content block file name should reflect the page it will be on, with a dash, and a descriptor. For example, a content block that will be wired to the index page should be named index-content. If there is more than one content block needed on a page, name them according to the type of content they contain for easy identification. For example, a file with feed content should be named index-feeds; in the same way, a slideshow for an index page should be named index-slideshow, and an announcement block for an index page should be named index-announcements. Naming content blocks this way helps show relationships between blocks and pages, which will make it easier to maintain in the future. Enter file name in "Definition Block Name" field.

Placement folder for Content Blocks

Content blocks should be located in a "_content" folder in your website folder. These "_content" folders can be inside every folder of your website, depending on how organized you want it to be; if you create more folders in your website, we suggest creating a "_content" folder inside each of them. You will need to create a "_content" folder if you do not have one.

Naming Articles

Add the month and day of publishing to the beginning of Article file names. For example, a news item titled "Professor Receives Grant" scheduled for publishing on March 8, 2019 should be named: 03-08-professor-receives-grant. 

Placement folder for Articles

Place all Articles in the "News" folder. Within the News folder, you should have a sub-folder that reflects your main website folder. For example, the Center for Civic Engagement has a main folder named "civic," so the "News" folder will have a "civic" sub-folder. Within this folder will be folders by year, and some may have subfolders by month, although this is rare. Articles should be placed in the folders corresponding to the year and/or month for its publication date.  For example the "Professor Receives Grant" article above should be placed in /news/civic/2019/ since it was written in 2019.

If your website's news folder does not have a folder for the current year, please ask itweb@jmu.edu to provide you with one.

Naming Events

Name Event files using the event date and event name. For example, if there's a Madison Brass Concert scheduled for February 28, 2019 name the event: 02-28-madison-brass-concert.

If you have multiple events scheduled for the same day, include the time in the file name. For example, if there are two Madison Brass Concerts scheduled for February 28, 2019 with one starting at 11:30 a.m. and one starting at 1 p.m., the files should be named 02-28-1130am-madison-brass-concert and 02-28-1pm-madison-brass-concert.

Placement folder for Events

Place all Events in the "events" folder. The Events folder will have year folders. From the previous example, an event scheduled for February 28, 2019 should be placed in your website's "2019" year folder.  For example, the brass-concert event above should be in "/events/music/2019/" if your website is "music" and the year of the event is 2019.  If your website's event folder does not have a folder for the current year, please ask itweb@jmu.edu to provide you with one.

Naming Profiles

Profile file names should follow the format lastname-firstname. For example, James Madison's profile file name would be madison-james, which should be entered in both the Display Name and Title fields. 

Good profile names:

  • smith-john
  • doe-jane

Bad profile names:

  • John Smith (Do NOT use spaces, capital letters, or formats other than lastname-firstname)
  • Doe, Jane (Do NOT use spaces, capital letters, or special characters like commas)

Placement folder for Profiles

Place all profiles in your main website folder under a folder named "people."

Back to Top