A custom origin is a subdomain that is configured for a specific customer and looks like: abc.pubnubapi.com

Using a custom origin allows PubNub to route traffic per customer when a point of presence is not performing well or becomes unavailable. It also allows for custom configurations that may be required by a customer for a specific use case or region. 

If you do not already have a custom origin you can request by filing a support ticket with PubNub Support, using the subject, Request Custom Origin. Be sure to provide the following to support in the ticket message body:

  1. Three choices for your subdomain in order of preference (12 characters or less)
  2. The PubNub SDKs you currently use in your applications: SDK language/name and version.
  3. Do you have customers or devices in China?


PubNub Support will provide you with confirmation on your custom origin name and sample code to configure for each of the PubNub SDKs/versions you are using in your applications.

NOTE: a paid plan is required to receive a custom origin.