Provider ID¶
Provider ID links a subscription to a provider account so the provider can see usage statistics for their subscription. It restricts nothing — the app works fully without it. Free.
How to send it (any method)
- URL query —
…?providerid=<ProviderID> - Comment in the subscription body — line
#providerid <ProviderID> - HTTP response header —
providerid:ors-providerid:
If several are provided, the HTTP header takes priority. You get your Provider ID (and the option to set a custom one) in the provider portal — see section 08.
✓ Without a Provider ID the subscription still works fully; the provider just gets no statistics. What does depend on an active Provider ID is listed below — the same tables are repeated at the end of this page for quick reference.
🔒Requires an active Provider ID¶
| Area | Keys |
|---|---|
| Bypass | s-fragment s-noise s-noises s-resolve s-dns — and their INCY/Happ equivalents fragmentation-* noises-* server-address-resolve-* |
| Migration & fallbacks | new-url new-domain fallback-url fallback-domains |
| Provider branding | s-siteurl s-sitename s-tgbot x-tgbot sort-order serverDescription |
| Banner & contacts | banner-text banner-button-text banner-button-url banner-bg-color banner-button-color announce-url support-email |
| Expiry UI | sub-expire s-showexpire sub-expire-button-text sub-expire-button-link-site sub-expire-button-link-tg notification-subs-expire |
| Access | hide-settings |
✓Works with or without a Provider ID¶
| Key | Note |
|---|---|
profile-title / s-title |
Subscription name |
profile-update-interval |
Auto-refresh interval |
profile-web-page-url |
Provider web page |
announce |
The announcement text itself — but announce-url (making it clickable) needs an active provider |
support-url |
Support link |
subscription-userinfo |
Quota and expiry date |
subid |
Stable subscription id |
routing autorouting routing-update-url routing-update-interval routing-profile |
Routing profiles, including the deep-link command forms — a profile carries rules only, so it needs no active provider |
geoipurl / geositeurl |
Geo database addresses — subscription response only |
The same gating applies however the value arrives — an HTTP header, a #key: line in the body, or the provider account.