{"id":10331,"date":"2024-09-02T16:09:15","date_gmt":"2024-09-02T08:09:15","guid":{"rendered":"https:\/\/conditionalblocks.com\/docs\/geolocation\/"},"modified":"2025-05-01T12:13:06","modified_gmt":"2025-05-01T04:13:06","slug":"geolocation","status":"publish","type":"docs","link":"https:\/\/conditionalblocks.com\/docs\/geolocation\/","title":{"rendered":"Geolocation"},"content":{"rendered":"\n

The Geolocation features use an external API to correctly detect the user location. WordPress cannot accurately detect the location on its own, however we’ve made it simple by using services provided by IPInfo.io<\/a>. <\/p>\n\n\n\n

https:\/\/ipinfo.io\/<\/a> has a generous free tier with 50,000<\/span> lookups per month.<\/p>\n\n\n\n

How to get started<\/h2>\n\n\n\n

Assuming you’ve already purchased and setup Conditional Blocks Pro on your WordPress site, then there’s only a few steps left before you can use one of the below Geolocation conditions.<\/p>\n\n\n\n

    \n
  1. Signup for your free API Key from https:\/\/ipinfo.io<\/a><\/li>\n\n\n\n
  2. Copy the API key<\/li>\n\n\n\n
  3. Secure your API key usage by whitelisting your domain name & server IP address. <\/li>\n\n\n\n
  4. Open a page in the WordPress Editor, then open Conditional Blocks and go the settings tab.<\/li>\n\n\n\n
  5. Paste & Verify that the API key is valid.<\/li>\n\n\n\n
  6. Add the Geolocation – Country<\/strong> condition to a content block, and choose the specific country.<\/li>\n\n\n\n
  7. That’s It! <\/li>\n<\/ol>\n\n\n\n
    \"Screenshot<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    \"Screenshot<\/figure>\n\n\n\n

    Developing WordPress locally?<\/strong>
    Local development site won’t detect your IP address correctly. You are WordPress site needs to be online for you to test geolocation features correctly.<\/p>\n\n\n\n

    FAQ<\/h2>\n\n\n\n

    How many API requests does the feature use?<\/h3>\n\n\n\n

    The IPinfo.io API will only be triggered once on the pages where you the Geolocation conditions.<\/p>\n\n\n\n

    In other words, 1 visitor = 1 API lookup on pages with Geolocation conditions.<\/p>\n\n\n\n

    The API lookup will only happen once, even if you use multiple geolocation check on the same page.<\/p>\n\n\n\n

    My Token is verified but Geolocation conditions aren’t working<\/h3>\n\n\n\n

    There could be two reasons why your blocks are not displaying as they should. <\/p>\n\n\n\n

      \n
    • Firstly make sure you are using live website (not local on your computer).<\/li>\n\n\n\n
    • Double check your security settings in IpInfo.io include the domain of your website & the server IP address. <\/li>\n\n\n\n
    • <\/li>\n<\/ul>\n","protected":false},"featured_media":0,"parent":0,"menu_order":5,"comment_status":"open","ping_status":"closed","template":"","meta":{"_uag_custom_page_level_css":"","nav_title":"","positive":"","negative":"","footnotes":""},"docs_category":[20],"class_list":["post-10331","docs","type-docs","status-publish","hentry","docs_category-features"],"blocksy_meta":[],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"docspress_archive":false,"1536x1536":false,"2048x2048":false,"sl-small":false,"sl-large":false},"uagb_author_info":{"display_name":"Morgan","author_link":"https:\/\/conditionalblocks.com\/author\/"},"uagb_comment_info":0,"uagb_excerpt":"The Geolocation features use an external API to correctly detect the user location. WordPress cannot accurately detect the location on its own, however we’ve made it simple by using services provided by IPInfo.io. https:\/\/ipinfo.io\/ has a generous free tier with 50,000 lookups per month. How to get started Assuming you’ve already purchased and setup Conditional…","_links":{"self":[{"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/docs\/10331","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/comments?post=10331"}],"version-history":[{"count":11,"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/docs\/10331\/revisions"}],"predecessor-version":[{"id":10626,"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/docs\/10331\/revisions\/10626"}],"wp:attachment":[{"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/media?parent=10331"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/conditionalblocks.com\/wp-json\/wp\/v2\/docs_category?post=10331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}