{"id":24283,"date":"2022-02-02T14:28:26","date_gmt":"2022-02-02T14:28:26","guid":{"rendered":"https:\/\/1-grid.com\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/"},"modified":"2023-10-19T13:01:46","modified_gmt":"2023-10-19T13:01:46","slug":"reasons-why-your-wordpress-plugins-or-themes-wont-install","status":"publish","type":"ht_kb","link":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/","title":{"rendered":"Reasons Why Your WordPress Plugins or Themes Won\u2019t Install"},"content":{"rendered":"
\n

7 Reasons Why Your WordPress Plugins or Themes Won\u2019t Install<\/span><\/h1>\n<\/div>\n
<\/div>\n
\n

For the most part, I think WordPress is a pretty solid platform. Of course, we complicate things when we drag third-party elements into it for the sake of improving performance or security, adding new design features, or opening up greater functionality. But the payoff is generally worth it. Without those integrations, you\u2019d have to do much more manual coding and that just doesn\u2019t isn\u2019t the most effective way to build a website these days.<\/span><\/p>\n

That said, there are times when issues arise when you try using WordPress plugins and themes on your website. As I\u2019ve talked about before, there are WordPress plugin conflicts that occur upon initial installation or during updates. But there are other ways in which they can cause issues for you before you even get them on the site.<\/p>\n

Below, I\u2019m going to break down the 7 reasons why a WordPress plugin or theme won\u2019t install on a website and some ways to get around these errors.<\/p>\n

7 Reasons Why Your WordPress Plugin or Theme Won\u2019t Install<\/h2>\n

The nice thing about these kinds of WordPress errors is that they\u2019re easy to identify. Usually, there\u2019s an error message that accompanies each failure to load, so there isn\u2019t as much troubleshooting with something like this as there are with other WordPress errors. It\u2019s just more annoying than anything else.<\/p>\n

So, here are the most common reasons why your WordPress plugin or theme won\u2019t install and what to do about them:<\/p>\n

1. The Wrong File Format Was Uploaded<\/h3>\n

Typically, you\u2019ll encounter an installation error during the manual upload of a theme or plugin through the Add New \/ Upload option in WordPress (as opposed to directly installing from the WordPress repository):<\/p>\n

\n
\"Plugin
Install your new WordPress plugins here.<\/figcaption><\/figure>\n<\/div>\n

When you see the following \u201cbad format\u201d message, it means that you have not uploaded the native files provided to you by the theme or plugin developer.<\/p>\n

\n
\"Plugin
This is what the \u201cbad format\u201d error looks like.<\/figcaption><\/figure>\n<\/div>\n

The only plugin or theme files that should ever be uploaded to WordPress are zip files.<\/p>\n

Before you get in touch with the plugin or theme developer, verify that you didn\u2019t receive the correct file from them. If this came from your client, they may have unzipped the folder and given you what they thought was the correct file from within. If it didn\u2019t come from the client and you really don\u2019t have the right folders, get in touch with the developer.<\/p>\n

2. Files Are Missing from the Zip<\/h3>\n

Now, let\u2019s say you did try and upload a zip file into WordPress, but you saw this error message instead:<\/p>\n

\n
\"Plugin
This is what the \u201cmissing files\u201d error looks like.<\/figcaption><\/figure>\n<\/div>\n

This means that the files contained within the folder are not what WordPress was expecting.<\/p>\n

Unzip the folder and review the contents. Is this even the correct zip? Does it contain all the files you would expect a plugin or theme to have? You can cross-check the contents of the folder against WordPress\u2019s recommendations for files that should be included in the package:<\/p>\n

    \n
  • A WordPress plugin package.<\/li>\n
  • A WordPress theme package.<\/li>\n<\/ul>\n

    If you\u2019ve detected any missing files, reach out to the developer for assistance.<\/p>\n

    3. There\u2019s a Syntax Error<\/h3>\n

    When you purchase a WordPress plugin or theme from a reputable developer, you shouldn\u2019t have to worry about this kind of error occurring.<\/p>\n

    However, let\u2019s say your client was trying to cut corners and save money, and so they found some plugin or theme online that looked promising. You try to install it in WordPress and you receive a syntax error. It\u2019ll usually say something about \u201cparse error\u201d and \u201csyntax error\u201d.<\/p>\n

    All this means is that there\u2019s something wrong in the code. This error can actually come up if you erroneously try to edit a theme or plugin once it\u2019s installed on your website. However, if you\u2019re seeing it during installation, then the error lies with the developer.<\/p>\n

    If you want to review the code of the plugin or theme on your own, you might be able to detect and repair the error yourself. Before you dig in, check into any other reported issues with the plugin or theme if there\u2019s a support system attached to it (through WordPress or a marketplace).<\/p>\n

    If there aren\u2019t any, your safest bet might be to have your client get a new plugin or theme. If you don\u2019t trust the developer to code the backend well, this issue could keep coming up with each new update (and you don\u2019t want to deal with that).<\/p>\n

    4. The Wrong Zip Was Uploaded<\/h3>\n

    This error is one you\u2019re probably going to encounter with larger, multipurpose themes. You received a zip file from your client and, by all intents and purposes, it looks to be in good shape. However, let\u2019s say you go to add the new theme:<\/p>\n

    \n
    \"Plugin
    Install your new WordPress theme here.<\/figcaption><\/figure>\n<\/div>\n

    Then you see this error:<\/p>\n

    \n
    \"Plugin
    This is what the stylesheet error looks like.<\/figcaption><\/figure>\n<\/div>\n

    In actuality, the stylesheet is not missing. You probably just downloaded the wrong version of the theme file.<\/p>\n

    Some developers offer up different zip packages for their themes, especially if they\u2019re including plugins and child themes within them. Here\u2019s an example of how Uncode includes various download options on Themeforest:<\/p>\n

    \n
    \"Plugin
    Various file downloads are available when you purchase a premium theme.<\/figcaption><\/figure>\n<\/div>\n

    While it\u2019s essential to have that full file with all the documentation, licenses, plugins, and alternate themes, that file cannot be uploaded into WordPress because it looks like this:<\/p>\n

    \n
    \"Plugin
    As you can see, the contents of this zip file weren\u2019t going to get me very far in WordPress.<\/figcaption><\/figure>\n<\/div>\n

    WordPress can unzip the top-level zip file, but it won\u2019t be able to go through and unzip everything else contained within the folder. If you want to get your theme in there, then you need to upload the proper zip file.<\/p>\n

    5. Memory Limits Are Exceeded<\/h3>\n

    I touched on this error recently when I talked about the server issues that affect WordPress. Basically, this happens when your web hosting PHP memory limit is too low to process the installation.<\/p>\n

    The error will say something like, \u201cFatal error: The allowed memory size of _______ bytes exhausted\u2026\u201d If you see this memory error, it\u2019s easy to fix.<\/p>\n

    Log in to the control panel of your site and open your preferred file editor: FTP or file manager. In the root directory, you\u2019ll find your wp-config.php file. Click on the edit button and add the following line of code:<\/p>\n

    define( 'WP_MEMORY_LIMIT', '256M' );<\/code><\/p>\n

    Since the default memory limit is usually 64M, this will significantly increase it and help you get your new theme or plugin installed without issue.<\/p>\n

    6. File Size Limits Are Exceeded<\/h3>\n

    Memory isn\u2019t the only thing that can be pushed to its limit when uploading a new WordPress plugin or theme. You may also find that the allowable file size is exceeded. When this occurs, you\u2019ll see a message similar to this:<\/p>\n

    \u201cThe uploaded file exceeds the upload_max_filesize directive in php.ini\u201d<\/p>\n

    To fix this maximum upload limit, you\u2019ll need to do so through the control panel. Access your directory using either FTP or a file manager. Once you\u2019re in there, locate the wp-admin folder.<\/p>\n

    Do you see a php.ini file? If not, you\u2019re going to have to create one.<\/p>\n

    Once you have the php.ini file open, look for a section that mentions \u201cfilesize\u201d. If it exists, you\u2019ll want to overwrite it with the following code. If it doesn\u2019t, then enter the following lines of code into the file:<\/p>\n

    upload_max_filesize = 1000M
    post_max_size = 2000M
    memory_limit = 3000M
    file_uploads = On
    \u00a0max_execution_time = 180<\/code><\/p>\n

    This will give you some more leeway in how large your WordPress theme and plugin files can be. If you\u2019re still experiencing problems with this error, read through Jenni McKinnon\u2019s guide on how to increase the maximum upload limit.<\/p>\n

    <\/h3>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

    7 Reasons Why Your WordPress Plugins or Themes Won\u2019t Install For the most part, I think WordPress is a pretty solid platform. Of course, we complicate things when we drag third-party elements into it for the sake of improving performance or security, adding new design features, or opening up greater…<\/p>\n","protected":false},"author":21,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"ht-kb-category":[24,27],"ht-kb-tag":[524,749,1005,1106,1148,1150],"class_list":["post-24283","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-website","ht_kb_category-wordpress","ht_kb_tag-install","ht_kb_tag-plugin","ht_kb_tag-theme","ht_kb_tag-web-hosting","ht_kb_tag-wont","ht_kb_tag-wordpress"],"yoast_head":"\nReasons Why Your Wordpress Plugins Or Themes Won\u2019t Install<\/title>\n<meta name=\"description\" content=\"Discover reasons why WordPress plugins or themes won't install with our guide: 1-grid Knowledge Base\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Reasons Why Your Wordpress Plugins Or Themes Won\u2019t Install\" \/>\n<meta property=\"og:description\" content=\"Discover reasons why WordPress plugins or themes won't install with our guide: 1-grid Knowledge Base\" \/>\n<meta property=\"og:url\" content=\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/\" \/>\n<meta property=\"og:site_name\" content=\"1-grid Knowledge Base\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/1grid.co.za\/\" \/>\n<meta property=\"article:modified_time\" content=\"2023-10-19T13:01:46+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/s3.amazonaws.com\/cdn.freshdesk.com\/data\/helpdesk\/attachments\/production\/33055056660\/original\/DAYops2OW7Z9mZ2wRcyinNiHpBoZX4s6vw.png?1614859921\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@1grid_hosting\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/\",\"url\":\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/\",\"name\":\"Reasons Why Your Wordpress Plugins Or Themes Won\u2019t Install\",\"isPartOf\":{\"@id\":\"https:\/\/1grid.co.za\/knowledge\/#website\"},\"datePublished\":\"2022-02-02T14:28:26+00:00\",\"dateModified\":\"2023-10-19T13:01:46+00:00\",\"description\":\"Discover reasons why WordPress plugins or themes won't install with our guide: 1-grid Knowledge Base\",\"breadcrumb\":{\"@id\":\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/1grid.co.za\/knowledge\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Reasons Why Your WordPress Plugins or Themes Won\u2019t Install\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/1grid.co.za\/knowledge\/#website\",\"url\":\"https:\/\/1grid.co.za\/knowledge\/\",\"name\":\"1-Grid Domain Hosting Knowledge Base\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/1grid.co.za\/knowledge\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/1grid.co.za\/knowledge\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/1grid.co.za\/knowledge\/#organization\",\"name\":\"1-Grid Domain Hosting Knowledge Base\",\"url\":\"https:\/\/1grid.co.za\/knowledge\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/1grid.co.za\/knowledge\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/1grid.co.za\/knowledge\/wp-content\/uploads\/2023\/01\/1-grid-logo-color.svg\",\"contentUrl\":\"https:\/\/1grid.co.za\/knowledge\/wp-content\/uploads\/2023\/01\/1-grid-logo-color.svg\",\"width\":100,\"height\":100,\"caption\":\"1-Grid Domain Hosting Knowledge Base\"},\"image\":{\"@id\":\"https:\/\/1grid.co.za\/knowledge\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/1grid.co.za\/\",\"https:\/\/twitter.com\/1grid_hosting\",\"https:\/\/www.instagram.com\/1grid_hosting\/\",\"https:\/\/za.linkedin.com\/company\/1-grid\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Reasons Why Your Wordpress Plugins Or Themes Won\u2019t Install","description":"Discover reasons why WordPress plugins or themes won't install with our guide: 1-grid Knowledge Base","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/","og_locale":"en_US","og_type":"article","og_title":"Reasons Why Your Wordpress Plugins Or Themes Won\u2019t Install","og_description":"Discover reasons why WordPress plugins or themes won't install with our guide: 1-grid Knowledge Base","og_url":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/","og_site_name":"1-grid Knowledge Base","article_publisher":"https:\/\/www.facebook.com\/1grid.co.za\/","article_modified_time":"2023-10-19T13:01:46+00:00","og_image":[{"url":"https:\/\/s3.amazonaws.com\/cdn.freshdesk.com\/data\/helpdesk\/attachments\/production\/33055056660\/original\/DAYops2OW7Z9mZ2wRcyinNiHpBoZX4s6vw.png?1614859921"}],"twitter_card":"summary_large_image","twitter_site":"@1grid_hosting","twitter_misc":{"Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/","url":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/","name":"Reasons Why Your Wordpress Plugins Or Themes Won\u2019t Install","isPartOf":{"@id":"https:\/\/1grid.co.za\/knowledge\/#website"},"datePublished":"2022-02-02T14:28:26+00:00","dateModified":"2023-10-19T13:01:46+00:00","description":"Discover reasons why WordPress plugins or themes won't install with our guide: 1-grid Knowledge Base","breadcrumb":{"@id":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/1grid.co.za\/knowledge\/reasons-why-your-wordpress-plugins-or-themes-wont-install\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/1grid.co.za\/knowledge\/"},{"@type":"ListItem","position":2,"name":"Reasons Why Your WordPress Plugins or Themes Won\u2019t Install"}]},{"@type":"WebSite","@id":"https:\/\/1grid.co.za\/knowledge\/#website","url":"https:\/\/1grid.co.za\/knowledge\/","name":"1-Grid Domain Hosting Knowledge Base","description":"","publisher":{"@id":"https:\/\/1grid.co.za\/knowledge\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/1grid.co.za\/knowledge\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/1grid.co.za\/knowledge\/#organization","name":"1-Grid Domain Hosting Knowledge Base","url":"https:\/\/1grid.co.za\/knowledge\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/1grid.co.za\/knowledge\/#\/schema\/logo\/image\/","url":"https:\/\/1grid.co.za\/knowledge\/wp-content\/uploads\/2023\/01\/1-grid-logo-color.svg","contentUrl":"https:\/\/1grid.co.za\/knowledge\/wp-content\/uploads\/2023\/01\/1-grid-logo-color.svg","width":100,"height":100,"caption":"1-Grid Domain Hosting Knowledge Base"},"image":{"@id":"https:\/\/1grid.co.za\/knowledge\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/1grid.co.za\/","https:\/\/twitter.com\/1grid_hosting","https:\/\/www.instagram.com\/1grid_hosting\/","https:\/\/za.linkedin.com\/company\/1-grid"]}]}},"_links":{"self":[{"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/ht-kb\/24283","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/comments?post=24283"}],"version-history":[{"count":2,"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/ht-kb\/24283\/revisions"}],"predecessor-version":[{"id":33010,"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/ht-kb\/24283\/revisions\/33010"}],"wp:attachment":[{"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/media?parent=24283"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/ht-kb-category?post=24283"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/1grid.co.za\/knowledge\/wp-json\/wp\/v2\/ht-kb-tag?post=24283"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}