{"id":20350,"date":"2026-11-22T08:46:53","date_gmt":"2026-11-22T05:46:53","guid":{"rendered":"https:\/\/www.hyyat.com\/knowledgebase\/install-wordpress-plugin-manually-ftp\/"},"modified":"2026-11-22T08:47:11","modified_gmt":"2026-11-22T05:47:11","password":"","slug":"install-wordpress-plugin-manually-ftp","status":"publish","type":"docs","link":"https:\/\/www.hyyat.com\/en\/knowledgebase\/install-wordpress-plugin-manually-ftp\/","title":{"rendered":"Install a WordPress Plugin Manually via FTP or File Manager: When Automatic Install Fails"},"content":{"rendered":"<div class=\"hkb\" dir=\"ltr\">\n<div class=\"hkb-tldr\"><b>In short<\/b>If installing a plugin from Add New fails, download its zip file from WordPress.org or the developer&#8217;s site, then try in order: <b>Upload Plugin<\/b> in the WordPress dashboard, or unzip it and upload its folder to <code>wp-content\/plugins<\/code> via <b>FTP<\/b> or the cPanel <b>File Manager<\/b>. Then activate it on the Plugins page.<\/div>\n<figure class=\"hkb-fig\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2026\/11\/hkb-tr-13356-en.webp\" alt=\"Install a WordPress Plugin Manually via FTP or File Manager: When Automatic Install Fails\" width=\"1200\" height=\"630\" loading=\"lazy\" \/><\/figure>\n<p>WordPress lets you install plugins with one click from Plugins, then Add New. Sometimes the install fails, because of file permissions, file size, a connection timeout, or because the plugin is a paid one not in the WordPress repository. In that case you upload it manually.<\/p>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/add-plugins.png\" alt=\"The Add New plugin page in the WordPress dashboard\" loading=\"lazy\" \/><\/figure>\n<h2>Method 1: the Upload Plugin button<\/h2>\n<ol class=\"hkb-steps\">\n<li><b>Download the plugin zip file<\/b> from WordPress.org or your account on the developer&#8217;s site.<\/li>\n<li><b>Open Plugins, then Add New,<\/b> and click <b>Upload Plugin<\/b> at the top.<\/li>\n<li><b>Choose the zip file<\/b> and click <b>Install Now<\/b>, then <b>Activate Plugin<\/b>.<\/li>\n<\/ol>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/download-plugin.png\" alt=\"Downloading the plugin from WordPress.org\" loading=\"lazy\" \/><\/figure>\n<p>If you get an error such as the file exceeding the upload size, or the upload fails, use method 2 or 3.<\/p>\n<h2>Method 2: via FTP<\/h2>\n<ol class=\"hkb-steps\">\n<li><b>Unzip the plugin<\/b> on your computer, which gives you a folder named after the plugin.<\/li>\n<li><b>Connect to your site with an FTP client<\/b> such as FileZilla, using the FTP details in your hosting activation email or the client area.<\/li>\n<li><b>Open the folder<\/b> <code>public_html\/wp-content\/plugins<\/code>, which has a folder for each installed plugin.<\/li>\n<li><b>Upload the plugin folder.<\/b> On the Local side, right-click the folder and choose <b>Upload<\/b>.<\/li>\n<li><b>Activate the plugin<\/b> from the WordPress dashboard, under Plugins.<\/li>\n<\/ol>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/plugin-extract.png\" alt=\"Unzipping the plugin on your computer\" loading=\"lazy\" \/><\/figure>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/ftp-login-1.png\" alt=\"Connecting to the site with FileZilla\" loading=\"lazy\" \/><\/figure>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/plugins-folders.png\" alt=\"The wp-content\/plugins folder with plugin folders\" loading=\"lazy\" \/><\/figure>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/ftp-local.png\" alt=\"Uploading the plugin folder with FileZilla\" loading=\"lazy\" \/><\/figure>\n<figure class=\"hkb-fig hkb-shot\"><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2019\/10\/active-plugin.png\" alt=\"Activating the plugin on the WordPress Plugins page\" loading=\"lazy\" \/><\/figure>\n<h2>Method 3: the cPanel File Manager<\/h2>\n<p>Without an FTP client: open cPanel, then <b>File Manager<\/b>, go to <code>public_html\/wp-content\/plugins<\/code>, click <b>Upload<\/b> and upload the zip file, then right-click it and choose <b>Extract<\/b>. Delete the zip file afterwards and activate the plugin in WordPress.<\/p>\n<h2>Common errors<\/h2>\n<div class=\"hkb-tbl\">\n<table>\n<thead>\n<tr>\n<th>Problem<\/th>\n<th>Fix<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>You uploaded the folder but the plugin does not appear<\/td>\n<td>Make sure the files sit directly inside one folder, not a folder inside a folder of the same name.<\/td>\n<\/tr>\n<tr>\n<td>&#8220;The package could not be installed&#8221;<\/td>\n<td>The uploaded file is not a plugin; you may have uploaded a theme or a zip with other files.<\/td>\n<\/tr>\n<tr>\n<td>The site breaks after activation<\/td>\n<td>Rename the plugin folder via FTP to disable it and bring the site back.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<div class=\"hkb-note\"><b>Careful:<\/b> do not install &#8220;free&#8221; copies of paid plugins from unofficial sites. Most are modified and carry malware. Read <a href=\"https:\/\/www.hyyat.com\/en\/knowledgebase\/choose-safe-wordpress-plugin\/\">how to choose a safe WordPress plugin<\/a>.<\/div>\n<div class=\"hkb-hh\">\n<h2>Summary<\/h2>\n<ul>\n<li>Try Upload Plugin first.<\/li>\n<li>If it fails, upload the folder to wp-content\/plugins via FTP or File Manager.<\/li>\n<li>Only download plugins from their official sources.<\/li>\n<\/ul>\n<p style=\"margin:10px 0 0\">Want hosting tuned for WordPress? See <a href=\"https:\/\/www.hyyat.com\/en\/wordpress-hosting\/\">WordPress Hosting<\/a>.<\/p>\n<\/div>\n<h2>Frequently asked questions<\/h2>\n<div class=\"hkb-faq\">\n<details>\n<summary>Where do plugin files go when uploading manually?<\/summary>\n<p>In <code>wp-content\/plugins<\/code> inside your site folder, each plugin in its own folder.<\/p>\n<\/details>\n<details>\n<summary>Do I upload the zip file or the folder?<\/summary>\n<p>Via FTP, upload the unzipped folder. With Upload Plugin or File Manager, upload the zip file.<\/p>\n<\/details>\n<details>\n<summary>Why does automatic install fail?<\/summary>\n<p>Usually file permissions, file size, a connection timeout, or a paid plugin that is not in the repository.<\/p>\n<\/details>\n<\/div>\n<div class=\"hkb-rel\"><b>Related guides<\/b><\/p>\n<ul>\n<li><a href=\"https:\/\/www.hyyat.com\/en\/knowledgebase\/install-wordpress-plugins\/\">How to Install WordPress Plugins: 3 Methods Step by Step<\/a><\/li>\n<li><a href=\"https:\/\/www.hyyat.com\/en\/knowledgebase\/update-wordpress-plugin-ftp\/\">How to Update a WordPress Plugin Manually via FTP<\/a><\/li>\n<li><a href=\"https:\/\/www.hyyat.com\/en\/knowledgebase\/choose-safe-wordpress-plugin\/\">How to Choose a Safe WordPress Plugin or Theme Before Installing It: 8 Checks<\/a><\/li>\n<li><a href=\"https:\/\/www.hyyat.com\/en\/knowledgebase\/update-wordpress-safely\/\">How to Update WordPress and Plugins Safely Without Breaking Your Site<\/a><\/li>\n<\/ul>\n<p><a href=\"https:\/\/www.hyyat.com\/en\/kb\/wordpress-explanations\/\">All guides in this section \u2192<\/a><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>In shortIf installing a plugin from Add New fails, download its zip file from WordPress.org or the developer&#8217;s site, then try in order: Upload Plugin in the WordPress dashboard, or unzip it and upload its folder to wp-content\/plugins via FTP or the cPanel File Manager. Then activate it on the Plugins page. WordPress lets you [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":20315,"comment_status":"open","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"_templately_pack_id":"","_templately_imported_at":"","_templately_source":"","_templately_import_session_id":"","footnotes":""},"doc_category":[2747],"doc_tag":[],"class_list":["post-20350","docs","type-docs","status-publish","has-post-thumbnail","hentry","doc_category-wordpress-explanations"],"year_month":"2026-11","word_count":530,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"admin","author_nicename":"admin","author_url":"https:\/\/www.hyyat.com\/en\/author\/admin\/"},"doc_category_info":[{"term_name":"WordPress Guides","term_url":"https:\/\/www.hyyat.com\/en\/kb\/wordpress-explanations\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/docs\/20350","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/comments?post=20350"}],"version-history":[{"count":0,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/docs\/20350\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/media\/20315"}],"wp:attachment":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/media?parent=20350"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/doc_category?post=20350"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/doc_tag?post=20350"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}