Whatever message this page gives is out now! Go check it out!

GetFileInfo

Last update:
May 18, 2026
Note:
You can find the CFFiddle demo of this function and other file functions as part of a project that is shared with you.
Click the button below to launch CFFiddle.
To copy the project in your workspace in CFFiddle, follow the steps below:
  1. Log in with your Gmail or Facebook credentials.
  2. Navigate to the project in the left pane.
  3. Once you make some changes in any cfm in the project, a pop up displays asking you to save the project.
  4. Give the project a suitable name and click Save.
  5. Create a folder named dir1 and upload a text file, myfile.txt.

Description

Retrieves information about on-disk or in-memory file.

Returns

The filename, path, parent directory, type, size, when the file was most recently modified, whether the file has read permission, write permission, and is hidden.
Category

Function syntax

GetFileInfo( filepath )

See also

History

ColdFusion (2018 release): Changed parameter name Path to  filepath .
ColdFusion 8: Added this function.

Parameters

Parameter
Description
filepath
Absolute on-disk or in-memory path.

Usage

The function returns a structure that includes the following keys:
  • Name: name of the file
  • Path: absolute path of the file
  • Parent: path to the file’s parent directory
  • Type: either "directory" or "file"
  • Size: file size in bytes
  • Lastmodified: datetime when it was the file was most recently modified
  • canRead: whether the file can be read
  • canWrite: whether the file has write permission
  • isHidden: whether the file is a hidden

Example

<cfscript> 

   FileSetLastModified("c:\temp\test1.txt", "#Now()#"); 

   WriteOutput(GetFileInfo("c:\temp\test1.txt").lastmodified); 

</cfscript

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page