{"id":2749,"date":"2026-05-30T13:46:26","date_gmt":"2026-05-30T13:46:26","guid":{"rendered":"https:\/\/wpseonext.com\/docs\/troubleshooting-install\/"},"modified":"2026-10-14T12:15:42","modified_gmt":"2026-10-14T12:15:42","slug":"troubleshooting-install","status":"publish","type":"page","link":"https:\/\/coocadev.com\/seo-suite\/docs\/troubleshooting-install\/","title":{"rendered":"Install Troubleshooting"},"content":{"rendered":"<style>\n    .wpsn-docs-guide {\n        width: min(1180px, calc(100% - 36px));\n        margin: 0 auto;\n        padding: 54px 0 86px;\n    }<\/p>\n<p>    .wpsn-docs-hero,\n    .wpsn-docs-section,\n    .wpsn-docs-table-wrap,\n    .wpsn-docs-checklist {\n        border: 1px solid #eef1f6;\n        background: #fff;\n        box-shadow: 0 22px 64px rgba(13, 25, 56, .06);\n    }<\/p>\n<p>    .wpsn-docs-hero {\n        display: grid;\n        grid-template-columns: minmax(0, 1fr) minmax(280px, .46fr);\n        gap: 24px;\n        align-items: center;\n        margin-bottom: 28px;\n        padding: clamp(34px, 5vw, 66px);\n        border-radius: 34px;\n        background:\n            radial-gradient(circle at 96% 0%, rgba(255, 98, 0, .17), transparent 240px),\n            radial-gradient(circle at 0% 100%, rgba(31, 139, 255, .10), transparent 220px),\n            linear-gradient(135deg, #ffffff 0%, #f8fbff 100%);\n    }<\/p>\n<p>    .wpsn-docs-kicker {\n        display: inline-flex;\n        align-items: center;\n        gap: 8px;\n        margin: 0 0 12px;\n        color: #ff6200;\n        font-size: 14px;\n        font-weight: 800;\n        letter-spacing: 0;\n        text-transform: uppercase;\n    }<\/p>\n<p>    .wpsn-docs-kicker::before {\n        content: \"\";\n        width: 9px;\n        height: 9px;\n        border-radius: 999px;\n        background: #ff6200;\n        box-shadow: 18px 0 0 #1f8bff;\n    }<\/p>\n<p>    .wpsn-docs-guide h2 {\n        margin: 0;\n        color: #17191d;\n        font-size: clamp(34px, 5vw, 64px);\n        line-height: 1.04;\n        letter-spacing: 0;\n    }<\/p>\n<p>    .wpsn-docs-guide h3 {\n        margin: 0 0 12px;\n        color: #17191d;\n        font-size: clamp(25px, 3vw, 36px);\n        line-height: 1.15;\n        letter-spacing: 0;\n    }<\/p>\n<p>    .wpsn-docs-guide p,\n    .wpsn-docs-guide li,\n    .wpsn-docs-guide td {\n        color: #626b78;\n        line-height: 1.66;\n    }<\/p>\n<p>    .wpsn-docs-hero p {\n        max-width: 760px;\n        margin: 18px 0 24px;\n        font-size: 18px;\n    }<\/p>\n<p>    .wpsn-docs-actions,\n    .wpsn-docs-chip-row {\n        display: flex;\n        flex-wrap: wrap;\n        gap: 10px;\n    }<\/p>\n<p>    .wpsn-docs-button,\n    .wpsn-docs-chip {\n        display: inline-flex;\n        align-items: center;\n        justify-content: center;\n        border-radius: 999px;\n        font-weight: 800;\n        text-decoration: none !important;\n    }<\/p>\n<p>    .wpsn-docs-button {\n        min-height: 50px;\n        padding: 13px 22px;\n        background: linear-gradient(135deg, #ff8a1f 0%, #ff6200 100%);\n        color: #fff !important;\n        box-shadow: 0 14px 34px rgba(255, 98, 0, .22);\n    }<\/p>\n<p>    .wpsn-docs-button.is-light,\n    .wpsn-docs-chip {\n        border: 1px solid #ffd7bd;\n        background: #fff;\n        color: #ff6200 !important;\n        box-shadow: none;\n    }<\/p>\n<p>    .wpsn-docs-snapshot {\n        display: grid;\n        gap: 12px;\n    }<\/p>\n<p>    .wpsn-docs-snapshot div {\n        padding: 16px;\n        border: 1px solid #e8eef8;\n        border-radius: 22px;\n        background: rgba(255, 255, 255, .88);\n    }<\/p>\n<p>    .wpsn-docs-snapshot strong {\n        display: block;\n        margin-bottom: 4px;\n        color: #17191d;\n        font-size: 17px;\n    }<\/p>\n<p>    .wpsn-docs-grid {\n        display: grid;\n        grid-template-columns: repeat(3, minmax(0, 1fr));\n        gap: 18px;\n    }<\/p>\n<p>    .wpsn-docs-section,\n    .wpsn-docs-table-wrap,\n    .wpsn-docs-checklist {\n        margin-top: 24px;\n        padding: clamp(26px, 4vw, 44px);\n        border-radius: 30px;\n    }<\/p>\n<p>    .wpsn-docs-steps {\n        counter-reset: wpsn-step;\n        display: grid;\n        gap: 14px;\n        margin: 0;\n        padding: 0;\n        list-style: none;\n    }<\/p>\n<p>    .wpsn-docs-steps li {\n        position: relative;\n        min-height: 72px;\n        padding: 18px 18px 18px 72px;\n        border: 1px solid #e8eef8;\n        border-radius: 22px;\n        background: #fff;\n    }<\/p>\n<p>    .wpsn-docs-steps li::before {\n        counter-increment: wpsn-step;\n        content: counter(wpsn-step);\n        position: absolute;\n        left: 18px;\n        top: 18px;\n        width: 36px;\n        height: 36px;\n        display: inline-flex;\n        align-items: center;\n        justify-content: center;\n        border-radius: 14px;\n        background: #fff2e8;\n        color: #ff6200;\n        font-weight: 900;\n    }<\/p>\n<p>    .wpsn-docs-steps strong {\n        display: block;\n        margin-bottom: 4px;\n        color: #17191d;\n        font-size: 18px;\n    }<\/p>\n<p>    .wpsn-docs-checklist ul {\n        display: grid;\n        grid-template-columns: repeat(2, minmax(0, 1fr));\n        gap: 12px;\n        margin: 0;\n        padding: 0;\n        list-style: none;\n    }<\/p>\n<p>    .wpsn-docs-checklist li {\n        position: relative;\n        padding-left: 28px;\n    }<\/p>\n<p>    .wpsn-docs-checklist li::before {\n        content: \"\";\n        position: absolute;\n        left: 0;\n        top: .55em;\n        width: 14px;\n        height: 14px;\n        border: 2px solid #ff6200;\n        border-radius: 50%;\n    }<\/p>\n<p>    .wpsn-docs-table {\n        width: 100%;\n        border-collapse: collapse;\n        overflow: hidden;\n    }<\/p>\n<p>    .wpsn-docs-table th,\n    .wpsn-docs-table td {\n        padding: 16px;\n        border-bottom: 1px solid #eef1f6;\n        text-align: left;\n        vertical-align: top;\n    }<\/p>\n<p>    .wpsn-docs-table th {\n        color: #17191d;\n        font-weight: 900;\n    }<\/p>\n<p>    .wpsn-docs-note {\n        margin-top: 24px;\n        padding: 22px;\n        border: 1px solid #ffe0c7;\n        border-radius: 24px;\n        background: linear-gradient(135deg, #fff4ec 0%, #eef7ff 100%);\n    }<\/p>\n<p>    .wpsn-docs-note p {\n        margin: 0;\n    }<\/p>\n<p>    @media (max-width: 991px) {\n        .wpsn-docs-hero,\n        .wpsn-docs-grid {\n            grid-template-columns: 1fr;\n        }\n    }<\/p>\n<p>    @media (max-width: 640px) {\n        .wpsn-docs-guide {\n            width: min(100% - 24px, 1180px);\n            padding-top: 34px;\n        }<\/p>\n<p>        .wpsn-docs-hero,\n        .wpsn-docs-section,\n        .wpsn-docs-table-wrap,\n        .wpsn-docs-checklist {\n            border-radius: 24px;\n        }<\/p>\n<p>        .wpsn-docs-checklist ul {\n            grid-template-columns: 1fr;\n        }<\/p>\n<p>        .wpsn-docs-table-wrap {\n            overflow-x: auto;\n        }\n    }\n<\/style>\n<div class=\"wpsn-docs-guide\">\n<section class=\"wpsn-docs-hero\" aria-label=\"Install troubleshooting overview\">\n<div>\n<div class=\"wpsn-docs-kicker\">Troubleshooting<\/div>\n<h2>Fix install problems<\/h2>\n<p>Most install issues are hosting limits, old PHP versions, or a license\/site URL mismatch. Start with the exact message you see.<\/p>\n<div class=\"wpsn-docs-actions\">\n                <a class=\"wpsn-docs-button\" href=\"https:\/\/coocadev.com\/seo-suite\/support\/\">Contact support<\/a><br \/>\n                <a class=\"wpsn-docs-button is-light\" href=\"https:\/\/coocadev.com\/seo-suite\/docs\/manual-install\/\">Manual install guide<\/a>\n            <\/div>\n<\/p><\/div>\n<div class=\"wpsn-docs-snapshot\">\n<div><strong>Stay calm<\/strong><span>If the front of the site loads, start by deactivating the plugin.<\/span><\/div>\n<div><strong>Keep the exact message<\/strong><span>A screenshot is often enough for support to identify the issue.<\/span><\/div>\n<div><strong>Do not delete settings first<\/strong><span>Support may need logs or settings to understand what happened.<\/span><\/div>\n<\/p><\/div>\n<\/section>\n<section class=\"wpsn-docs-table-wrap\">\n<h3>Common messages<\/h3>\n<table class=\"wpsn-docs-table\">\n<thead>\n<tr>\n<th>User sees<\/th>\n<th>Plain meaning<\/th>\n<th>First fix<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>The uploaded file exceeds the upload_max_filesize directive<\/td>\n<td>The host blocks large ZIP uploads.<\/td>\n<td>Increase the PHP upload limit or install through hosting file manager.<\/td>\n<\/tr>\n<tr>\n<td>WordPress asks for FTP credentials<\/td>\n<td>WordPress cannot write to the plugins folder.<\/td>\n<td>Ask hosting to fix file ownership or permissions.<\/td>\n<\/tr>\n<tr>\n<td>Plugin could not be activated because it triggered a fatal error<\/td>\n<td>The server hit a PHP or plugin conflict.<\/td>\n<td>Copy the full error, disable the plugin, and contact support.<\/td>\n<\/tr>\n<tr>\n<td>License invalid<\/td>\n<td>The key is wrong or not found.<\/td>\n<td>Copy the key again from My Account.<\/td>\n<\/tr>\n<tr>\n<td>License used on another domain<\/td>\n<td>The key is already attached elsewhere.<\/td>\n<td>Remove the old site from the license or contact support.<\/td>\n<\/tr>\n<tr>\n<td>Updates do not appear<\/td>\n<td>The site cannot confirm the license or update feed.<\/td>\n<td>Save the license again, then check WordPress updates.<\/td>\n<\/tr>\n<tr>\n<td>Scan is very slow<\/td>\n<td>Large sites or hosting security can slow the first scan.<\/td>\n<td>Scan one content type first and retry during a quiet time.<\/td>\n<\/tr>\n<tr>\n<td>Another SEO plugin is active<\/td>\n<td>Two SEO plugins can manage the same metadata.<\/td>\n<td>Do not delete anything yet; choose which plugin owns titles and descriptions before importing.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/section>\n<section class=\"wpsn-docs-section\">\n<h3>Safe recovery<\/h3>\n<ol class=\"wpsn-docs-steps\">\n<li><strong>If the site still loads<\/strong>Open Plugins and deactivate SEO Next.<\/li>\n<li><strong>If admin is unavailable<\/strong>Temporarily rename the installed plugin folder through your hosting file manager: coocadev-seo-suite for Free, or wp-seo-next for paid editions.<\/li>\n<li><strong>If a license changed domains<\/strong>Check whether the site moved from staging to production.<\/li>\n<li><strong>If you need help<\/strong>Send WordPress version, PHP version, hosting company, SEO Next version, plan, and the exact error.<\/li>\n<\/ol>\n<\/section>\n<div class=\"wpsn-docs-note\">\n<p>Do not delete the plugin folder until support has checked whether settings or logs are needed.<\/p>\n<\/p><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Fix common SEO Next install problems: upload limits, FTP prompts, activation errors, license messages, updates, and slow scans.<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":2348,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_wpsn_focus_keyword":"","_wpsn_seo_title":"","_wpsn_meta_description":"","_wpsn_canonical":"","_wpsn_robots_index":"","_wpsn_robots_follow":"","_wpsn_og_title":"","_wpsn_og_description":"","_wpsn_og_image":"","_wpsn_twitter_title":"","_wpsn_twitter_description":"","_wpsn_twitter_image":"","_wpsn_schema_type":"","_wpsn_schema_custom_json_ld":"","_wpsn_video_url":"","_wpsn_video_title":"","_wpsn_video_description":"","_wpsn_video_thumbnail":"","_wpsn_video_duration":0,"footnotes":""},"class_list":["post-2749","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/pages\/2749","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/types\/page"}],"replies":[{"embeddable":true,"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/comments?post=2749"}],"version-history":[{"count":2,"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/pages\/2749\/revisions"}],"predecessor-version":[{"id":2809,"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/pages\/2749\/revisions\/2809"}],"up":[{"embeddable":true,"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/pages\/2348"}],"wp:attachment":[{"href":"https:\/\/coocadev.com\/seo-suite\/wp-json\/wp\/v2\/media?parent=2749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}