Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.40

(Home >> Files >> File Manager)

Overview

File Manager allows cPanel users to manage and edit their files.

The File Manager Directory Selection window

When you open File Manager:

  1. The File Manager Directory Selection window will appear. Select which of four main directories you wish to view in the file window when File Manager opens:
    • The home directory (/home/user)
    • Web Root (/public_html/www)
    • Public FTP Root (/public_ftp)
    • Document Root (/public_html)
  2. If you wish to see hidden files, select the Show Hidden Files checkbox.
  3. If you do not wish to see the File Manager Directory Selection window again, select the Skip this question checkbox.
  4. Click Go.

The File Manager interface opens in a new browser window. The selected directory will display in the file window.

The File Manager toolbar

The File Manager toolbar shows the following functions available to manage your files:

FeatureIconDescription
New FileCreates a new file with a user-defined file extension.
New FolderCreates a new folder in the current directory.
CopyCopies selected items to a user-specified directory.
Move FileMoves the selected files to a new directory.
UploadUploads files to the selected directory.
DownloadDownloads selected files to your computer.
DeleteDeletes selected files from the server.
RenameRenames the selected file or folder.
EditOpens the selected files in a text editor.
Code EditorOpens the selected files in a code editor.
HTML EditorOpens the selected HTML file in a visual HTML editor. To learn more about the editor's functions, visit our HTML Editor documentation.
Change PermissionsChanges the read, write, and execute permissions for selected files.
ViewOpens the selected file so that you can view the code.
ExtractExtracts the selected *.zip*.Gz, or *.Bz2 archive and stores the files in a directory.
CompressCompresses the selected files to a single *.zip*.Gz, or *.Bz2 archive and stores the compressed file in a specified directory.

Note

  • When a toolbar action is not available, the function icon turns gray.
  • Certain File Manager functions are designed for use with only one file at a time. Select the desired file in the file window before you attempt these actions.
  • Any attempt to RenameEdit, or View multiple files at the same time will only affect the first listed file in the directory.
  • The Extract and Compress functions will only work with the .zip format if Zip is installed on your server. Your system administrator can run the command yum install zip to install the Zip module.

Character encoding verification dialogs

When you edit a file with EditCode Editor, or HTML Editor, a window will appear to confirm the file's character encoding. Use the menu to select the correct character encoding for the file. Then, click Edit to continue.

  • Click Toggle Help to display more information about how to select the correct character encoding.
  • Click Disable Encoding Check to turn off future verification dialogs.

You can also turn Character Encoding Verification Dialogs on or off through Settings:

  1. Click Settings in the top left corner of File Manager. A new window will appear.
  2. Enable or disable Character Encoding Verification Dialogs:
    • To turn the encoding verification off, select the Disable Character Encoding Verification Dialogs checkbox.
    • To turn the encoding verification on, deselect the Disable Character Encoding Verification Dialogs checkbox.
  3. Click Save

Warning

If you choose the wrong initial encoding, your file may become corrupt. If your file displays as a series of special characters, immediately abort the edit and select the correct encoding. Do not save the file.

Select a directory

You can use the file tree or the location text box to navigate your files and folders.

There are several ways you can use the file tree (located to the left of the file window) to browse your files:

  • Click on the name of the folder you wish to view
  • Click on the  next to the  icon to view a list of subfolders in that folder.
    • You can click on the  next to an expanded directory to collapse it.

Warning

After you expand a list of subfolders, click on the folder name to view the folder's contents.

To use the location text box directly above the file tree:

  1. Enter the path of the folder you wish to view.
  2. Click Go. The file window will display the contents of the chosen folder.

The file window

The file window displays the contents of the selected directory. If there are no files or folders in the selected folder, the file window will display the message "This directory is empty."

Information about files and subfolders will display in the following columns:

FeatureDescription
File IconFiles will display an icon that corresponds to the file type. Folders will display the  icon.
NameThe filename.
SizeThe size of the file, displayed in bytes, KB, MB, etc.
Last ModifiedThe date and time the file was last modified.
TypeThe media (MIME) type and subtype.
PermsThe permissions setting for the file, in octal notation. The default permission setting is 0644.

Note

You can click on a column's heading to sort the file list by that column's value.

The navigation toolbar

You can use the toolbar at the top of the file window to navigate between folders in the file window.

FeatureDescription
HomeNavigates directly to the home directory (/home/user).
Up One LevelNavigates to the folder that contains the currently selected folder. This option is greyed out when the home directory is selected.
BackReturns to the folder that was viewed immediately before the currently selected folder.
ForwardNavigates to the next folder that you viewed, after you use Back.
ReloadRefreshes the displayed list of files and folders.
Select all

Selects all displayed files and folders. 

Remember

Any attempt to RenameEdit, or View multiple files at the same time will only affect the first listed file in the directory.

Unselect allDeselects all files and folders currently displayed.

 

File and folder actions

You can right-click on files or folders in the file window to choose from a menu of actions customized to the file's type.

FeatureDisplays forDescription
DownloadFiles, Compressed FilesDownloads the selected file to your computer.
ViewFiles, Compressed FilesOpens the selected file so you can view the code.
EditFilesOpens the selected files in a text editor.
Code EditFilesOpens the selected files in a code editor.
HTML EditFilesOpens the selected HTML file in a visual HTML editor.
MoveFiles, Compressed Files, FoldersMove the selected file or folder to a new directory.
CopyFiles, Compressed Files, FoldersCopies the selected file or folder to a user-specified directory.
RenameFiles, Compressed Files, FoldersRenames a selected file or folder.
Change PermissionsFiles, Compressed Files, FoldersAllows a user to change the read, write, and execute permissions for selected files or folders.
DeleteFiles, Compressed Files, FoldersDeletes the selected files or folders from the server.
ExtractCompressed FilesExtracts the selected *.zip*.Gz, or *.Bz2 archive and stores the files in a directory.
CompressFiles, Compressed Files, FoldersCompresses the selected files or folders to a single *.zip*.Gz, or *.Bz2 archive and stores the compressed file to a specified directory.
Password ProtectFolders

Sets a username and password to restrict access to a folder. 

Note

Your service provider must enable this feature.

Leech ProtectFolders

Redirects users who may have shared the password to a restricted area of your site with others. Accounts that exceed a set number of logins in a two hour period will be redirected to a selected URL, or receive an internal server error message. 

Note

Your service provider must enable this feature.

Manage IndicesFolders

Customizes the way users view a directory on the web. 

Note

Your service provider must enable this feature.

Search for a file

The Search tool, located at the top right corner of the interface, allows users to search for a specific file. By default, Search will search all files in the home directory. You can also limit the search to the document root at/home/user/public_html, or to the directory displayed in the file window.

To search for a file:

  1. Use the Search menu to choose the directory to search: All Your Filesonly public_html or Current Directory.
  2. Enter the desired file name in the text box.
  3. Click Go.

A new window displays the filenames that match your search. To go to a folder, or to the containing folder for a file, double-click on the desired item in the list. If there are no files that include your search term, you will see the message No records found.