{"id":14548,"date":"2020-12-08T12:39:25","date_gmt":"2020-12-08T12:39:25","guid":{"rendered":"http:\/\/wiki2.plumserver.com\/?post_type=ht_kb&#038;p=14548"},"modified":"2026-03-30T03:47:02","modified_gmt":"2026-03-30T07:47:02","slug":"magento-2-ip-geolocation-lookup-v1-x-configuration-2","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration","title":{"rendered":"Magento 2 IP Geolocation Lookup v1.x Configuration"},"content":{"rendered":"\n<h2 id=\"h-general\">General<\/h2>\n\n\n\n<p>Here you will learn how to configure <a href=\"\/magento-geoip-lookup\">Magento 2 IP Geolocation Lookup<\/a> v1.x extension correctly. <\/p>\n\n\n\n<p><strong>In the main menu go to &#8220;Plumrocket&#8221; tab &gt; select &#8220;IP Geolocation Lookup&#8221; extension &gt; navigate to &#8220;Configuration&#8221; section.<\/strong><\/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 actions:<\/p>\n\n\n\n<ol><li>&#8220;<strong>Enable Extension&#8221;:<\/strong>&nbsp;this option allows you to enable or disable this IP Geolocation Lookup extension for Magento 2.<\/li><li><strong>&#8220;Serial Key&#8221;:<\/strong>&nbsp;enter the unique serial key provided to you after purchasing the extension.&nbsp;<strong>Note<\/strong>:&nbsp;In most cases, this field will be pre-filled with a serial key automatically, and the green checkmark will be displayed. To find and paste your serial key manually, read the&nbsp;<strong><a href=\"\/docs\/general\/magento-license-installation\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">Serial Key Activation<\/a><\/strong>&nbsp;article.<\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img src=\"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_1-0000-1.png\" alt=\"\" class=\"wp-image-17037\"\/><\/figure>\n\n\n\n<h2 id=\"h-services\">Services<\/h2>\n\n\n\n<p>In this section, you can learn how to connect to a database from which you want to retrieve data. You can enable one or more databases at a time. This is useful for the automatic retrieval of geographic location information from other databases in case one of them fails.<\/p>\n\n\n\n<h3 id=\"h-maxmind-geoip-database\">Maxmind GeoIP Database<\/h3>\n\n\n\n<p>When this database is enabled, geolocation lookups will use GeoLite2 data created by <a href=\"https:\/\/www.maxmind.com\/\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">MaxMind<\/a>. You can retrieve information about the country, state, city, postal code, time zone, locale, latitude, and longitude.<\/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 actions:<\/p>\n\n\n\n<ol><li>&#8220;<strong>Enable Maxmind GeoIP<\/strong>&#8220;: this option allows you to enable or disable the Maxmind GeoIP database.<\/li><li>&#8220;<strong>Database Status<\/strong>&#8220;: you can view the installation status and the current version of the database in this field.<\/li><li>&#8220;<strong>Installation Method<\/strong>&#8220;:<ul><li>set to <em>&#8220;Automatic Installation&#8221;<\/em> if you want to install the Maxmind GeoIP database automatically. Then press the Install Database button. <\/li><li>set to<em>&#8220;Manual Installation&#8221;<\/em> if you want to install the database manually. Please follow our <a href=\"\/docs\/magento-geoip-lookup\/v1\/devguide\/databases-manual-installation\n\" target=\"_blank\" rel=\"noreferrer noopener\">Databases Manual Installation<\/a> developer&#8217;s guide to learn how to install the databases manually.<\/li><\/ul><\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img src=\"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_2-1.png\" alt=\"\" class=\"wp-image-17038\"\/><\/figure>\n\n\n\n<h3 id=\"h-iptocountry-database\">IpToCountry Database<\/h3>\n\n\n\n<p>If you don&#8217;t need detailed location information, enable the IpToCountry database. It includes only the list of countries.<\/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 actions:<\/p>\n\n\n\n<ol><li>&#8220;<strong>Enable IpToCountry<\/strong>&#8220;: this option allows you to enable or disable the IpToCountry database.  <\/li><li>&#8220;<strong>Database Status<\/strong>&#8220;: you can view the installation status and the current version of the database in this field.<\/li><li>&#8220;<strong>Installation Method<\/strong>&#8220;: <ul><li>set to <em>&#8220;Automatic Installation&#8221;<\/em> if you want to install the IpToCountry database automatically. Then press the Install Database button.<\/li><li>set to<em>&#8220;Manual Installation&#8221;<\/em> if you want to install the database manually. Please follow our <a aria-label=\"undefined (opens in a new tab)\" href=\"\/docs\/magento-geoip-lookup\/v1\/devguide\/databases-manual-installation\" target=\"_blank\" rel=\"noreferrer noopener\">Databases Manual Installation<\/a> developer&#8217;s guide to learn how to install the databases manually. <\/li><\/ul><\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img src=\"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_3-1.png\" alt=\"\" class=\"wp-image-17039\"\/><\/figure>\n\n\n\n<h3 id=\"h-ipapi-com-ip-geolocation-api\">Ipapi.Com &#8211; IP Geolocation API<\/h3>\n\n\n\n<p>Ipapi provides an easy-to-use API interface that allows you to view various information related to IPv4 and IPv6 addresses.<\/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 actions:<\/p>\n\n\n\n<ol><li>&#8220;<strong>Enable GeoIP API<\/strong>&#8220;: this option allows you to enable or disable the GeoIP API.<\/li><li>&#8220;<strong>Acess Key<\/strong>&#8220;: <ul><li>Register on <a href=\"https:\/\/ipapi.com\/\" rel=\"nofollow\">https:\/\/ipapi.com\/<\/a> and get your free API Key. Under the free plan, you are limited to 10,000 lookups a month and can retrieve only location data. To get more data and increase the lookups limit, consider paid plans. <\/li><li>Enter your API key in the Access Key field. Then, press the Test Connection button and a green checkmark will be displayed informing you of a successful connection.<\/li><\/ul><\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img src=\"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_4-1.png\" alt=\"\" class=\"wp-image-17040\"\/><\/figure>\n\n\n\n<h2 id=\"h-ip-geolocation-lookup-test\">IP Geolocation Lookup Test<\/h2>\n\n\n\n<p>In this section you are able to test the specific IP adress and see what information is displayed.<\/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 actions:<\/p>\n\n\n\n<ol><li>&#8220;<strong>IP Address<\/strong>&#8220;: enter any valid IP address to test IP Geolocation Lookup. Your own IP address is automatically filled in.<\/li><li>&#8220;<strong>Test GeoIP Lookup<\/strong>&#8220;: press the Get Location From IP button to retrieve location data from the entered IP address.<\/li><li>&#8220;<strong>IP Geolocation Information<\/strong>&#8220;: if the IP address is correct and you have at least one of the three services enabled, then the location data will be displayed in this field. By default, the IP Geolocation Lookup extension uses services in the order in which they appear in the backend of the extension&#8217;s configurations (Maxmind &gt; IpToCountry &gt; IpApi).<\/li><li>&#8220;<strong>View Location on Map<\/strong>&#8220;: click on the provided link to view the location of the IP address on Google Maps. Please note that the link is created based on Latitude and Longitude data returned from the IP Geolocation service. Hence, if the service for some reason did not return Latitude and Longitude data, the location link will be incorrect.<\/li><li>&#8220;<strong>REST API<\/strong>&#8220;: click on the provided link to see what location data you can get with the REST API. Read more about REST API and other methods of retrieving IP Geolocation data in our&nbsp;<a aria-label=\"undefined (opens in a new tab)\" target=\"_blank\" href=\"\/docs\/magento-geoip-lookup\/v1\/devguide\/rest-api\" rel=\"noreferrer noopener nofollow\">Rest API Reference<\/a>. <\/li><\/ol>\n<\/div><\/div>\n\n\n\n<figure class=\"wp-block-image size-full\"><img src=\"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_5-1.png\" alt=\"\" class=\"wp-image-17041\"\/><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>General Here you will learn how to configure Magento 2 IP Geolocation Lookup v1.x extension correctly. In the main menu go to &#8220;Plumrocket&#8221; tab &gt; select &#8220;IP Geolocation Lookup&#8221; extension &gt; navigate to &#8220;Configuration&#8221; section. Services In this section, you can learn how to connect to a database from which you want to retrieve data. &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Magento 2 IP Geolocation Lookup v1.x Configuration&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"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":[197],"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 Configure Magento 2  IP Geolocation Lookup Extension v1.x Magento 2 IP Geolocation Lookup v1.x Configuration - Plumrocket Documentation<\/title>\n<meta name=\"description\" content=\"General Here you will learn how to configure Magento 2 IP Geolocation Lookup v1.x extension correctly. In the main menu go to &quot;Plumrocket&quot; tab &gt; select\" \/>\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\/v1\/configuration\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Magento 2 IP Geolocation Lookup v1.x Configuration\" \/>\n<meta property=\"og:description\" content=\"General Here you will learn how to configure Magento 2 IP Geolocation Lookup v1.x extension correctly. In the main menu go to &quot;Plumrocket&quot; tab &gt; select\" \/>\n<meta property=\"og:url\" content=\"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration\" \/>\n<meta property=\"og:site_name\" content=\"Plumrocket Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2020-12-08T12:39:25+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-30T07:47:02+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_1-0000-1.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=\"5 minutes\" \/>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"How to Configure Magento 2  IP Geolocation Lookup Extension v1.x Magento 2 IP Geolocation Lookup v1.x Configuration - Plumrocket Documentation","description":"General Here you will learn how to configure Magento 2 IP Geolocation Lookup v1.x extension correctly. In the main menu go to \"Plumrocket\" tab &gt; select","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\/v1\/configuration","og_locale":"en_US","og_type":"article","og_title":"Magento 2 IP Geolocation Lookup v1.x Configuration","og_description":"General Here you will learn how to configure Magento 2 IP Geolocation Lookup v1.x extension correctly. In the main menu go to \"Plumrocket\" tab &gt; select","og_url":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration","og_site_name":"Plumrocket Documentation","article_published_time":"2020-12-08T12:39:25+00:00","article_modified_time":"2026-03-30T07:47:02+00:00","og_image":[{"url":"https:\/\/plumrocket.com\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_1-0000-1.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Written by":"Plumrocket","Est. reading time":"5 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\/v1\/configuration#primaryimage","inLanguage":"en-US","url":"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_1-0000-1.png","contentUrl":"\/docs\/wp-content\/uploads\/2021\/01\/Magento-2-GeoIP-Lookup-Extension_1-0000-1.png"},{"@type":"WebPage","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration#webpage","url":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration","name":"Magento 2 IP Geolocation Lookup v1.x Configuration - Plumrocket Documentation","isPartOf":{"@id":"https:\/\/plumrocket.com\/docs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration#primaryimage"},"datePublished":"2020-12-08T12:39:25+00:00","dateModified":"2026-03-30T07:47:02+00:00","author":{"@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/38b360639b934d6c984ee4f3ffce7d20"},"description":"General Here you will learn how to configure Magento 2 IP Geolocation Lookup v1.x extension correctly. In the main menu go to \"Plumrocket\" tab &gt; select","breadcrumb":{"@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1\/configuration#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Magento 2 Extensions","item":"https:\/\/plumrocket.com\/magento-extensions"},{"@type":"ListItem","position":2,"name":"Magento 2 IP Geolocation Lookup","item":"https:\/\/plumrocket.com\/magento-ip-geolocation-lookup"},{"@type":"ListItem","position":3,"name":"Documentation","item":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup"},{"@type":"ListItem","position":4,"name":"v1","item":"https:\/\/plumrocket.com\/docs\/magento-ip-geolocation-lookup\/v1"},{"@type":"ListItem","position":5,"name":"Configuration"}]},{"@type":"Person","@id":"https:\/\/plumrocket.com\/docs\/#\/schema\/person\/38b360639b934d6c984ee4f3ffce7d20","name":"Plumrocket","image":{"@type":"ImageObject","@id":"https:\/\/plumrocket.com\/docs\/#personlogo","inLanguage":"en-US","url":"https:\/\/secure.gravatar.com\/avatar\/72392a92ae750c66560be284502b6676?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/72392a92ae750c66560be284502b6676?s=96&d=mm&r=g","caption":"Plumrocket"},"sameAs":["https:\/\/plumrocket.com\/docs"]}]}},"_links":{"self":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/14548"}],"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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/comments?post=14548"}],"version-history":[{"count":6,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/14548\/revisions"}],"predecessor-version":[{"id":29035,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/posts\/14548\/revisions\/29035"}],"wp:attachment":[{"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/media?parent=14548"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/categories?post=14548"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/plumrocket.com\/docs\/wp-json\/wp\/v2\/tags?post=14548"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}