Skip to main content



Ipify is a simple Public IP Address API, it returns your public IP Adress in plain text.

Sample Configuration#

"type": "ipify",
"style": "diamond",
"foreground": "#ffffff",
"background": "#c386f1",
"leading_diamond": "๎‚ถ",
"trailing_diamond": "\uE0B0",
"properties": {
"template": "{{ .IP }}",
"cache_timeout": 5,
"http_timeout": 1000


  • url: string - The Ipify URL, by default IPv4 is used, use for IPv6 - defaults to
  • http_timeout: int - How long may the segment wait for a response of the ipify API? - defaults to 20ms
  • cache_timeout: int in minutes - How long do you want your IP address cached? - defaults to 10 min
  • template: string - a go text/template template extended with sprig utilizing the properties below. - defaults to {{ .IP }}

Template Properties#

  • .IP: string - Your external IP address