How to Use cPanel File Manager: Upload, Edit, and Manage Files

Overview

cPanel File Manager is the browser-based file management tool built into every cPanel account. It lets you upload, edit, move, copy, delete, and set permissions on files without needing an FTP client like FileZilla. Most users reach for it when they need to make a quick edit to a config file, upload a plugin manually, or recover from a bad file permission change that’s broken their site.

It’s not a replacement for FTP or SFTP when you’re working with hundreds of files at once — but for day-to-day tasks on a Shared Hosting account, it’s fast, convenient, and always available from any device with a browser.

This article covers the full workflow: accessing File Manager, navigating your directory structure, uploading files, editing code in-browser, managing permissions, and working with compressed archives.

Prerequisites

• Active hosting account with cPanel access (cPanel version 106 or later — though most steps apply to older versions too)
• Your cPanel login credentials (username and password, or SSO from your Host & Tech client area)
• Basic understanding of where your website files live — typically public_html for your primary domain
• If uploading a ZIP archive: the files already compressed locally before starting

Step-by-Step Instructions

Step 1: Open File Manager

1. Log in to cPanel. Your URL will look like yourdomain.com/cpanel or yourdomain.com:2083.
2. In the search bar at the top of the cPanel dashboard, type File Manager and click the result. Alternatively, find it under the Files section.
3. File Manager opens directly in your home directory (/home/yourusername). Your website files are inside the public_html folder.

📝 Note: If you manage multiple domains (addon domains or subdomains), each has its own document root. Addon domain files are typically stored in a subfolder of public_html or a parallel directory like /home/yourusername/addondomain.com. Check Domains in cPanel to confirm the exact path.

Step 2: Navigate Your Directory Structure

1. Use the left-hand folder tree to browse directories, or double-click folders in the main panel.
2. The breadcrumb trail at the top shows your current path — click any segment to jump back up.
3. To go directly to a path, click Go to (or press G) and type the full path, e.g.:

/home/yourusername/public_html/wp-content/themes

4. Use the Search field (top right) to find files by name within the current directory tree.

Step 3: Upload Files

1. Navigate to the destination folder (e.g., public_html).
2. Click the Upload button in the top toolbar.
3. A new browser tab opens with an upload interface. Drag and drop files onto the page, or click Select File to browse locally.
4. Watch the progress bar. Once it hits 100%, close the tab and return to File Manager — your files are there.

⚠ Warning: File Manager has a default upload limit tied to your PHP upload_max_filesize setting, usually 256MB on shared plans. If you’re uploading something larger — a full site backup, for example — upload it as a ZIP and extract it server-side (covered in Step 6). Trying to upload a 500MB uncompressed folder through the browser will either fail silently or time out.

Step 4: Edit a File In-Browser

1. Right-click the file you want to edit and choose Edit. For HTML, PHP, CSS, or JS files, this opens a syntax-highlighted code editor.
2. Make your changes.
3. Click Save Changes in the top right of the editor tab.
4. Close the editor tab to return to File Manager.

📝 Note: There’s also a Code Editor option in the right-click menu — this version skips the encoding warning dialog and drops you straight into editing. I’d recommend using Code Editor for PHP and config files to avoid the extra click.

⚠ Warning: Always take a copy of a file before editing it in production. Right-click the file, choose Copy, and paste it to the same directory with a .bak extension before you change anything. There’s no undo in File Manager once you save.

Step 5: Set File Permissions (chmod)

1. Right-click a file or folder and select Change Permissions.
2. A dialog shows checkboxes for Read, Write, and Execute for Owner, Group, and World.
3. Set the numeric value directly in the field at the bottom, or use the checkboxes.

Common permission values for web hosting:

# Files: 644 (owner can read/write; group and world can read)
# Directories: 755 (owner can read/write/execute; others can read/execute)
# wp-config.php: 600 or 640 (owner read/write only)
# Writable cache/upload dirs: 755 (never 777 on production)

⚠ Warning: Setting directories to 777 (world-writable) is a security risk. On shared hosting, it means other users on the same server could potentially write to your directory. If a plugin or installer is asking you to set something to 777, that’s a red flag worth investigating.

Step 6: Upload and Extract a ZIP Archive

This is the right approach for bulk file uploads.

1. Compress your files into a .zip archive locally.
2. Upload the ZIP using the Upload button (as in Step 3).
3. Once uploaded, right-click the ZIP file in File Manager.
4. Click Extract. A dialog asks where to extract — confirm the path and click Extract File(s).
5. Delete the ZIP file after extraction to keep your directory clean.

📝 Note: File Manager supports .zip extraction natively. For .tar.gz or .tar.bz2 archives, right-click and look for the Extract option — cPanel handles those too. If you don’t see it, you may need to extract via SSH instead.

Step 7: Move, Copy, Rename, and Delete Files

• Rename: Right-click → Rename, or click the file once and press F2.
• Move: Right-click → Move. Type the full destination path in the dialog.
• Copy: Right-click → Copy. Same path-based dialog.
• Delete: Select the file(s) and click Delete in the toolbar, or press Delete. Check Skip the trash only if you’re certain — deleted files that bypass trash can’t be recovered from File Manager.

Common Issues & Troubleshooting

Upload fails or stops at a percentage

This is almost always a file size or PHP timeout issue. The upload hits your account’s upload_max_filesize or post_max_size limit, or the server’s execution timeout kicks in mid-transfer. Switch to ZIP + extract for large uploads. If the problem persists on small files, check whether your browser has an extension blocking the upload request (ad blockers can interfere with cPanel’s upload handler).

“Permission denied” when trying to edit or delete a file

The file is owned by a different system user or has restrictive permissions. This commonly happens with files created by a WordPress auto-update, a plugin installer, or a server process running as nobody or apache. If you’re on a shared host, contact support to correct the ownership. If you have SSH access, you can check and fix it yourself:

ls -la /home/yourusername/public_html/wp-config.php
chown yourusername:yourusername /home/yourusername/public_html/wp-config.php

File Manager is blank or won’t load past the loading spinner

Usually a browser compatibility issue or a JavaScript conflict from a browser extension. Try opening File Manager in a private/incognito window with extensions disabled. cPanel’s File Manager is a JavaScript-heavy application — it needs a modern browser and can be sensitive to aggressive content blockers. If it still fails, clear your browser cache or try a different browser entirely.

Extracted ZIP files are in the wrong location

When you click Extract, the dialog defaults to extracting relative to the current directory. If you uploaded the ZIP to public_html and extract with the default path, the contents land in public_html directly. If the ZIP itself contains a top-level folder, you’ll get a nested directory you didn’t want. Always check the archive’s internal structure before extracting, and adjust the path in the extract dialog if needed.

Changes saved in File Manager aren’t showing on the site

Hard-refresh your browser first (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac). If that doesn’t help, a caching layer is probably serving the old version. Check if a caching plugin (like WP Super Cache or W3 Total Cache) is active on your WordPress site, or if your hosting plan includes a server-level cache — purge it. On Host & Tech managed WordPress plans, you can clear the cache directly from the WordPress admin toolbar.

FAQ