{"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 class=\"wp-block-paragraph\">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 is-layout-flow wp-block-group-is-layout-flow\">\n<p class=\"pr-notice-title wp-block-paragraph\"><strong>Important Information:<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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 class=\"wp-block-paragraph\">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 is-layout-flow wp-block-group-is-layout-flow\">\n<p class=\"pr-notice-title wp-block-paragraph\"><strong>Important Information:<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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 class=\"wp-block-heading\" id=\"h-step-1-back-up-your-data\">Step 1. Back Up your data<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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 class=\"wp-block-heading\" id=\"h-step-2-update-the-extension\">Step 2. Update the Extension<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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 is-layout-flex wp-block-buttons-is-layout-flex\">\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 class=\"wp-block-heading\" id=\"h-updating-extension-via-composer\">Updating Extension via Composer<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">First, remove the following folders if they exist:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><code class=\"\" data-line=\"\">app\/code\/Plumrocket\/GeoIPLookup<\/code><\/li><li><code class=\"\" data-line=\"\">app\/code\/Plumrocket\/Base<\/code><\/li><\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Then, update the extension files by running the following command from the Magento root directory:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>Use this command if the IP Geolocation Lookup v1 Extension was installed in the <code class=\"\" data-line=\"\">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\" data-line=\"\">composer update plumrocket\/module-geo-ip-lookup<\/code><\/pre><\/div>\n\n\n\n<ul class=\"wp-block-list\"><li>Use this command if the IP Geolocation Lookup v1 Extension was installed in the <code class=\"\" data-line=\"\">app\/code\/Plumrocket\/GeoIPLookup<\/code> folder.<\/li><\/ul>\n\n\n\n<div class=\"wp-block-prismatic-blocks\"><div><\/div><pre><code class=\"\" data-line=\"\">composer require plumrocket\/module-geo-ip-lookup<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">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 class=\"wp-block-paragraph\">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\" data-line=\"\">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 class=\"wp-block-heading\" id=\"h-updating-extension-via-ftp\">Updating Extension via FTP<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In order to update the extension files via FTP, remove the <code class=\"\" data-line=\"\">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 class=\"wp-block-heading\" id=\"h-step-3-import-the-maxmind-and-iptocountry-databases\">Step 3. Import the Maxmind and IpToCountry databases<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">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 is-layout-flow wp-block-group-is-layout-flow\">\n<p class=\"pr-notice-title wp-block-paragraph\"><strong>Important Information:<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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 class=\"wp-block-heading\" id=\"h-importing-the-databases-automatically\">Importing the databases automatically<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">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 is-layout-flow wp-block-group-is-layout-flow\">\n<p class=\"pr-notice-title wp-block-paragraph\">Step-by-step guide:<\/p>\n\n\n\n<ol class=\"wp-block-list\"><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\" decoding=\"async\" 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=\"auto, (max-width: 1203px) 100vw, 1203px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-importing-the-databases-manually\">Importing the databases manually<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">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. Important Information: We strongly recommend upgrading and testing the IP Geolocation Lookup extension in a development environment before deploying it on the production shop. The difference between IP Geolocation &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,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[2],"tags":[],"class_list":["post-27557","post","type-post","status-publish","format-standard","hentry","category-magento-extensions","entry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.1 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\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 - Plumrocket Documentation\" \/>\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=\"author\" content=\"Plumrocket\" \/>\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 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 - Plumrocket Documentation","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","type":"","width":"","height":""}],"author":"Plumrocket","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Plumrocket","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#article","isPartOf":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading"},"author":{"name":"Plumrocket","@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/c96fccdb89342ae6804272265723eca8"},"headline":"How to Upgrade Magento 2 IP Geolocation Lookup Extension from v1.x to v2.x","datePublished":"2024-08-15T09:47:03+00:00","dateModified":"2026-03-13T08:31:07+00:00","mainEntityOfPage":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading"},"wordCount":473,"image":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#primaryimage"},"thumbnailUrl":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png","articleSection":["Magento 2 Extensions"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading","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"},"image":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#primaryimage"},"thumbnailUrl":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2026\/03\/magento2-ip-geo-lookup-v1.x-to-v2.x.png","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":"ImageObject","inLanguage":"en-US","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v2\/upgrading#primaryimage","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":"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":"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":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/c96fccdb89342ae6804272265723eca8","name":"Plumrocket","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/30d7e8cb4567485b56880a1658849a1252ac12806e8f95b3be71e986bf5eabee?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/30d7e8cb4567485b56880a1658849a1252ac12806e8f95b3be71e986bf5eabee?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/30d7e8cb4567485b56880a1658849a1252ac12806e8f95b3be71e986bf5eabee?s=96&d=mm&r=g","caption":"Plumrocket"}}]}},"_links":{"self":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/27557","targetHints":{"allow":["GET"]}}],"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}]}}