App management
Manage application settings via subscription
The application management functionality includes two areas:
Standard parameters that work for most panels.
Advanced parameters for which you need to specify the Provider ID
To enable a parameter, pass the value true or 1; to disable it, pass any other non-empty value.
Standard Parameters
Subscription Auto-Update
A task is created in the system to perform the operation at the specified interval. Depending on internal priorities, the system tries to run the subscription update at the set time. If for any reason the update was not performed within the specified interval, it will occur automatically on the next app launch. The interval is set in hours and must be a multiple of one hour.
Example of configuring this parameter:
profile-update-interval: [int]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-update-interval: 1#profile-update-interval: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Subscription Name
The name of the subscription profile. Can be passed as plain text or base64 (UTF-8). Restriction: Maximum length — 25 characters.
In the subscription body, specify the parameter with a # (e.g., #profile-title)
Example of configuring this parameter:
profile-title: [string]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-title: Name VPN#profile-title: Name VPN
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Subscription Status String (traffic, expiration date)
Displays information about balance, used traffic volume, and subscription expiration date. On the left side of the scale in the app, the amount of used traffic (upload + download) is shown, and on the right — the total volume (total) after the "/" symbol. The subscription expiration date is specified in the expire parameter. Note: all data is transmitted in one header and separated by the ; symbol.
Example of configuring this parameter:
subscription-userinfo: [string]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622#subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Support Page Link
A button to go to the support page. Displayed as a blue icon on the right. If the link leads to Telegram, a Telegram icon is shown; otherwise, a standard link icon is used.
Example of configuring this parameter:
support-url: [string]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
support-url: https://t.me/happ_chat#support-url: https://t.me/happ_chat
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Website Link
A button to go to the subscription website. Displayed as a blue icon on the left. If the parameter is not set, the icon will be gray.
Example of configuring this parameter:
profile-web-page-url: [string]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
profile-web-page-url: https://happ.su#profile-web-page-url: https://happ.su
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Announcement
The subscription can contain an announcement message, passed as plain text or Base64. Restriction: maximum length of displayed text — 200 characters.
Example of configuring this parameter:
announce: [string]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
announce: base64:SGFwcCB0aGUgYmVzdCE=#announce: base64:SGFwcCB0aGUgYmVzdCE=
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Advanced Parameters
Provider ID parameter is required!
Server Description in Subscription
Allows setting an additional caption displayed under the server name instead of the standard text (e.g., "VMess", "VLESS", "Trojan").
Maximum length — 30 characters.
If it doesn't fit on the screen, it will be shortened with an ellipsis.
Set after
titlevia the?separator.
Examples:
vless://[email protected]:443?encryption=none&node_id=482&headerType=none&type=tcp&security=reality&sni=booking.com&fp=chrome&pbk=YqHW8a4iAc1SZYpTrFVoOQg1F3yAdX1tWXuROZUCsEU[...]vmess://eyJob3N0IjoiZWxhaG9tZWtpdGNoZW4uY29tIiwicGF0aCI6IiIsInRscyI6IiIsImFkZCI6ImVsYWhvbWVraXRjaGVuLmNvbSIsInBvcnQiOjUwMDAsImFpZCI6MCwibmV0IjoidGNwIiwidHlwZSI6Im5vbmUiLCJ2IjoiMiIsInBzIjoi4piB77iPIDog[...]trojan://[email protected]:443?security=tls&insecure=1&fragment=3,1,tlshello&type=ws&headerType=&path=%2F&host=quictest.burncommunity.ru&sni=quictest.burncommunity.ru&fp=chrome&al[...]socks://pkg-private2-country-us-city-new_york_city:[email protected]:1080#title?serverDescription=SGFwcCB0aGUgYmVzdA==ss://[email protected]:9042#title?serverDescription=SGFwcCB0aGUgYmVzdA==wireguard://[email protected]:10803?publickey=asd33d223d33&address=dom.ru&allowinsecure=1&mtu=1500&reserved=1,22,33#title?serverDescription=SGFwcCB0aGUgYmVzdA=={
"dns": {
...
},
"inbounds": [
...
],
"outbounds": [
...
],
"remarks": "🇭🇰 Hong Kong",
"meta": {
"serverDescription": "Happ the best"
}
}Hide Server Settings in Subscription
Disable the ability to view and edit server configurations for users of your subscription. Not available for all apps.
Example of configuring this parameter:
hide-settings: [true / 1]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
hide-settings: 1#hide-settings: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Application Settings Management
Provider ID parameter is required!
Disable Subscription Collapse
This function disables the ability to collapse a subscription: the server list is always fully displayed.
Example of configuring this parameter:
subscriptions-collapse: [String] Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
subscriptions-collapse: 1#subscriptions-collapse: 1
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Ping Display Mode
Allows displaying icons instead of time values.
Example of configuring this parameter:
ping-result: [time,icon]Ways to pass it:
HTTP/2 200
date: Wed, 24 Nov 2024 10:00:52 GMT
content-type: application/json
content-length: 3798
content-disposition: attachment; filename="213"
ping-result: icon#ping-result: icon
vless://70cc48c5‑b2f4…
vmess://zkIAU1JitkI…Last updated