Skip to main content



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

Sample Configuration#

"type": "ipify",
"style": "diamond",
"foreground": "#ffffff",
"background": "#c386f1",
"leading_diamond": "๎‚ถ",
"trailing_diamond": "\uE0B0",
"template": "{{ .IP }}",
"properties": {
"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 (info)#

default template
{{ .IP }}


  • .IP: string - Your external IP address