> For the complete documentation index, see [llms.txt](https://docs.inova.us/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inova.us/v1/ipiphy-ip-geolocation-plugin.md).

# ipiphy - IP Geolocation Plugin

Quickly retrieve your user's public IP address along with detailed geolocation data including country, city, and state. Simple to use and easy to integrate—get up and running in seconds.

{% hint style="danger" %}
This is a data-only API plugin. It does not include any visual elements and won’t appear in your Bubble design editor.
{% endhint %}

## Instructions

1. Sign up at [geo.ipify.org](https://geo.ipify.org/)
2. Visit your [Subscriptions page](https://geo.ipify.org/subscriptions)
3. Copy your personal API key from there

## How to Retrieve a User’s IP Address

1. To get the user’s IP address, set up a simple client-side API call using the following URL:\
   `https://api64.ipify.org?format=json`
2. This call returns the user’s IP in JSON format. Once retrieved, you can pass the IP address into this plugin to enable seamless geolocation functionality.

<figure><img src="https://2270479705-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lby9-31FtGubTBCYpg4%2Fuploads%2FAsjpaRfOZISOGSF9TjgU%2Fc2bf30da57460353bfa1122014650c49cccef46b.png?alt=media&amp;token=af7fe671-1966-4eec-ad5b-e13ebd8793f4" alt=""><figcaption></figcaption></figure>

## Setup Instructions

1. Enter your API key in the plugin settings under the **Plugins** tab.
2. Use the IP geolocation data in your UI or workflows according to your specific use case.

<figure><img src="https://2270479705-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lby9-31FtGubTBCYpg4%2Fuploads%2FnYnOPQ2Hprf7x0c4lcJk%2F28d7496da0a4d07d9fbdea77a7eac5894a8a878b.png?alt=media&amp;token=136aef17-6aa8-4d02-90c3-65615df3b781" alt=""><figcaption></figcaption></figure>