{"id":27557,"date":"2024-08-15T05:47:03","date_gmt":"2024-08-15T09:47:03","guid":{"rendered":"https:\/\/plumrocket.com\/docs\/?p=27557"},"modified":"2026-03-13T04:31:07","modified_gmt":"2026-03-13T08:31:07","slug":"how-to-upgrade-magento-2-ip-geolocation-lookup-extension-from-v1-x-to-v2-x","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading","title":{"rendered":"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x"},"content":{"rendered":"\n<p>In this article, you will learn how to upgrade the&nbsp;<a href=\"\/magento-geoip-lookup\">Magento 2 IP Geolocation Lookup extension<\/a>&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or Composer.<\/p>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-warning\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\"><strong>Important Information:<\/strong><\/p>\n\n\n\n<p>We strongly recommend upgrading and testing the IP Geolocation Lookup extension in a development environment before deploying it on the production shop.<\/p>\n<\/div><\/div>\n\n\n\n<p>The difference between <strong>IP Geolocation Lookup v1.x<\/strong> and <strong>v2.x<\/strong> is that in <strong>v1.x<\/strong>, the <strong>Maxmind<\/strong> and <strong>IpToCountry<\/strong> work is based on the Magento database, while in <strong>v2.x<\/strong>, this work is based on the <strong>mmdb files<\/strong>. Because of this, please follow the steps described below to make the integrations work properly.<\/p>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-warning\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\"><strong>Important Information:<\/strong><\/p>\n\n\n\n<p>If you already configured the Maxmind and IpToCountry integrations in your Magento, they will stop working after the extension upgrade, so you should perform additional configurations.<\/p>\n<\/div><\/div>\n\n\n\n<h2 id=\"h-step-1-back-up-your-data\">Step 1. Back Up your data<\/h2>\n\n\n\n<p>We strongly recommend that you back up all your Magento 2 files and folders before you proceed with updating the extension to ensure the whole process runs smoothly.<\/p>\n\n\n\n<h2 id=\"h-step-2-update-the-extension\">Step 2. Update the Extension<\/h2>\n\n\n\n<p>You can choose one of the two following methods to update the extension on your Magento 2 store:<\/p>\n\n\n\n<div class=\"wp-block-buttons\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link has-background\" href=\"#updating-extension-via-composer\" style=\"background-color:#33b0e2\"><strong>1. Updating via Composer<\/strong><\/a><\/div>\n\n\n\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link has-background\" href=\"#updating-extension-via-ftp\" style=\"background-color:#c9383d\"><strong>2. Updating via FTP<\/strong><\/a><\/div>\n<\/div>\n\n\n\n<h3 id=\"h-updating-extension-via-composer\">Updating Extension via Composer<\/h3>\n\n\n\n<p>First, remove the following folders if they exist:<\/p>\n\n\n\n<ul><li><code>app\/code\/Plumrocket\/GeoIPLookup<\/code><\/li><li><code>app\/code\/Plumrocket\/Base<\/code><\/li><\/ul>\n\n\n\n<p>Then, update the extension files by running the following command from the Magento root directory:<\/p>\n\n\n\n<ul><li>Use this command if the IP Geolocation Lookup v1 Extension was installed in the <code>vendor\/plumrocket\/module-geo-ip-lookup<\/code> folder.<\/li><\/ul>\n\n\n\n<div class=\"wp-block-prismatic-blocks\"><div><\/div><pre><code class=\"language-php\">composer update plumrocket\/module-geo-ip-lookup<\/code><\/pre><\/div>\n\n\n\n<ul><li>Use this command if the IP Geolocation Lookup v1 Extension was installed in the <code>app\/code\/Plumrocket\/GeoIPLookup<\/code> folder.<\/li><\/ul>\n\n\n\n<div class=\"wp-block-prismatic-blocks\"><div><\/div><pre><code class=\"language-\">composer require plumrocket\/module-geo-ip-lookup<\/code><\/pre><\/div>\n\n\n\n<p>After running the command, you may be prompted to enter the username and password. In order to find your personal Username and Password to update the extension via the Composer,&nbsp;go to your <strong><a href=\"\/downloadable\/customer\/products\" rel=\"nofollow\">Plumrocket account<\/a> &gt; My Downloads<\/strong>, find the required Plumrocket extension in the list, and click the <strong>Install via Composer<\/strong> link.&nbsp;<\/p>\n\n\n\n<p>Run the next four Magento 2 commands to complete the updating process:<\/p>\n\n\n\n<div class=\"wp-block-prismatic-blocks\"><div><\/div><pre><code class=\"language-php\">php bin\/magento cache:flush\nphp bin\/magento setup:upgrade\nphp bin\/magento setup:di:compile\nphp bin\/magento setup:static-content:deploy<\/code><\/pre><\/div>\n\n\n\n<h3 id=\"h-updating-extension-via-ftp\">Updating Extension via FTP<\/h3>\n\n\n\n<p>In order to update the extension files via FTP, remove the <code>app\/code\/Plumrocket\/GeoIPLookup<\/code> folder and perform the <a href=\"\/docs\/magento-geoip-lookup\/v2\/installation#extension-installation-via-ftp\">Installation via FTP<\/a> steps.<\/p>\n\n\n\n<h2 id=\"h-step-3-import-the-maxmind-and-iptocountry-databases\">Step 3. Import the Maxmind and IpToCountry databases<\/h2>\n\n\n\n<p>Our extension offers two options for the Maxmind and IpToCountry databases import: automatic and manual.<\/p>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-warning\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\"><strong>Important Information:<\/strong><\/p>\n\n\n\n<p>To <strong>reduce the site&#8217;s downtime<\/strong> during the push to your live site, we recommend <strong>swapping steps 2 and 3<\/strong> of this documentation and performing the <strong>database manual import<\/strong> before the extension update.<\/p>\n<\/div><\/div>\n\n\n\n<h3 id=\"h-importing-the-databases-automatically\">Importing the databases automatically<\/h3>\n\n\n\n<p>To update the databases automatically, go to <strong>Plumrocket &gt; IP Geolocation Lookup &gt; Configuration &gt; Maxmind IP Geolocation Database (IpToCountry IP Geolocation Database)<\/strong> and do the following:<\/p>\n\n\n\n<div class=\"wp-block-group pr-notice pr-notice-info\"><div class=\"wp-block-group__inner-container\">\n<p class=\"pr-notice-title\">Step-by-step guide:<\/p>\n\n\n\n<ol><li>Change the &#8220;<strong>Installation Method<\/strong>&#8221; to &#8220;<strong>Automatic Installation<\/strong>&#8220;.<\/li><li>Press the <strong>Install Database<\/strong> button.<\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" width=\"1203\" height=\"536\" src=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png\" alt=\"GeoIP_Lookup_upgrading-1\" class=\"wp-image-28998\" srcset=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png 1203w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x-300x134.png 300w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x-1024x456.png 1024w, https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x-768x342.png 768w\" sizes=\"(max-width: 1203px) 100vw, 1203px\" \/><\/figure>\n\n\n\n<h3 id=\"h-importing-the-databases-manually\">Importing the databases manually<\/h3>\n\n\n\n<p>To install the databases manually, please follow our <a href=\"\/docs\/magento-geoip-lookup\/v2\/devguide\/databases-manual-installation\" target=\"_blank\" rel=\"noreferrer noopener\">Databases Manual Installation<\/a> developer&#8217;s guide.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this article, you will learn how to upgrade the&nbsp;Magento 2 IP Geolocation Lookup extension&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or Composer. The difference between IP Geolocation Lookup v1.x and v2.x is that in v1.x, the Maxmind and IpToCountry work is based on the Magento database, while in v2.x, this work &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x&#8221;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_mi_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[2],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v17.2 (Yoast SEO v17.2) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x - Plumrocket Documentation<\/title>\n<meta name=\"description\" content=\"In this article, you will learn how to upgrade the&nbsp;Magento 2 IP Geolocation Lookup extension&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x\" \/>\n<meta property=\"og:description\" content=\"In this article, you will learn how to upgrade the&nbsp;Magento 2 IP Geolocation Lookup extension&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or\" \/>\n<meta property=\"og:url\" content=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading\" \/>\n<meta property=\"og:site_name\" content=\"Plumrocket Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2024-08-15T09:47:03+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-13T08:31:07+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Plumrocket\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x - Plumrocket Documentation","description":"In this article, you will learn how to upgrade the&nbsp;Magento 2 IP Geolocation Lookup extension&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or","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:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading","og_locale":"en_US","og_type":"article","og_title":"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x","og_description":"In this article, you will learn how to upgrade the&nbsp;Magento 2 IP Geolocation Lookup extension&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or","og_url":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading","og_site_name":"Plumrocket Documentation","article_published_time":"2024-08-15T09:47:03+00:00","article_modified_time":"2026-03-13T08:31:07+00:00","og_image":[{"url":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"Plumrocket","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebSite","@id":"https:\/\/plumrocket.com\/docs\/#website","url":"https:\/\/plumrocket.com\/docs\/","name":"Plumrocket Documentation","description":"Extensions docs, troubleshootings etc.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/plumrocket.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"ImageObject","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#primaryimage","inLanguage":"en-US","url":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png","contentUrl":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png","width":1203,"height":536},{"@type":"WebPage","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#webpage","url":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading","name":"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x - Plumrocket Documentation","isPartOf":{"@id":"https:\/\/plumrocket.com\/docs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#primaryimage"},"datePublished":"2024-08-15T09:47:03+00:00","dateModified":"2026-03-13T08:31:07+00:00","author":{"@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/c96fccdb89342ae6804272265723eca8"},"description":"In this article, you will learn how to upgrade the&nbsp;Magento 2 IP Geolocation Lookup extension&nbsp;from v1.x to v2.x using two methods \u2013 via FTP or","breadcrumb":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Docs","item":"https:\/\/plumrocket.com\/docs"},{"@type":"ListItem","position":2,"name":"Magento 2 Extensions","item":"https:\/\/plumrocket.com\/docs\/magento-extensions"},{"@type":"ListItem","position":3,"name":"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x"}]},{"@type":"Person","@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/c96fccdb89342ae6804272265723eca8","name":"Plumrocket","image":{"@type":"ImageObject","@id":"https:\/\/plumrocket.com\/docs\/#personlogo","inLanguage":"en-US","url":"https:\/\/secure.gravatar.com\/avatar\/10c44aa45aab391250913d982e552e53?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/10c44aa45aab391250913d982e552e53?s=96&d=mm&r=g","caption":"Plumrocket"}}]}},"_links":{"self":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27557"}],"collection":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/comments?post=27557"}],"version-history":[{"count":12,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27557\/revisions"}],"predecessor-version":[{"id":29000,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27557\/revisions\/29000"}],"wp:attachment":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/media?parent=27557"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/categories?post=27557"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/tags?post=27557"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}