Service info

The Provider tab in the app shows who issued the profile: name, logo, cover and links — website, support, guides. All of this comes from a JSON file you host yourself.

Where it lives

The file’s address is the provider_info_url field in the X-Meta header. If it’s absent, the app requests the info from provider_url — you can return the JSON right at your website’s address.

Example

{
  "version": 1,
  "name": "Example VPN",
  "logo": "https://example.com/cosmos/logo.png",
  "cover": "https://example.com/cosmos/cover.webp",
  "sections": [
    {
      "title": "Account",
      "links": [
        { "title": "Dashboard", "url": "https://example.com/account", "icon": "panel" }
      ]
    },
    {
      "title": "Help",
      "footer": "We reply from 9 am to 9 pm",
      "links": [
        { "title": "Support", "url": "https://t.me/example_support", "icon": "support" },
        { "title": "Guides", "url": "https://example.com/help", "icon": "docs" }
      ]
    }
  ]
}

Fields

Field	Format	If absent or invalid
version	integer, currently 1; required	The info isn’t shown
name	string	The domain of provider_url or of the subscription link
logo	https://, PNG / JPEG / WebP, square from 256×256, up to 256 KB	The first letter of the name
cover	https://, PNG / JPEG / WebP, about 3:1, up to 1 MB	A gradient
sections	up to 4 sections, up to 12 links across all of them	If absent — links is used
sections[].title	up to 32 characters — the section title	A section without a title
sections[].footer	up to 120 characters — a caption under the section	No caption
sections[].links	a list of links, like links[]	A section without valid links is skipped
links	up to 8 links as one Contact section — for older app versions without sections; you can return both fields	One Website button from provider_url
links[].title	up to 24 characters	The link is skipped
links[].url	https://, tg:// or mailto:	The link is skipped
links[].icon	a name from the list below	Chosen by the address

Icons: link, panel, support, chat, mail, docs, status, news, telegram, whatsapp, vk, discord, youtube, x. Without icon, the icon is chosen by the link’s address.

The file — up to 64 KB.