Fully integrate our vision test into your experience.

Our API experience supports custom domains for the user's vision test experience, generated upon authentication.

Visibly-Hosted (Recommended)

If you'd like to use your own domain, we have the option to host the proxy domain for you on the condition that you provide us the certificate for your subdomain for configuration within our services.

If you don't want to manage your own domain, there is the option to reserve a subdomain on our site, such as yoursubdomain.govisibly.com.


If you'd prefer to manage the domain yourself, we require that you host the experience via a branded reverse proxy hostname. These hostnames should be a fully qualified domain name, e.g. yoursubdomain.yourdomain.com, that is accessible on the internet.

Your proxies must be able to receive HTTPS requests (self-signed certificates are fine for staging environments) and forward the requests to us in their entirety using standard reverse proxy directives. Requests received via HTTP should be redirected to HTTPS, as all of our environments require a secure connection.

It's important that the requests to and responses from our service are forwarded without being modified to ensure that the vision test experience functions properly. The one exception to this is the HTTP Host header, which might need to be set explicitly for proxied requests depending on the technology you select. See the Nginx sample below for an example of this.

The implementation of your branded reverse proxy hostname will vary based on your technology stack. Amazon Web Services is the preferred method since it's easy to set up, maintainable, and performant. Below are some guides and example configurations to help you get started.

If you're using another technology and get stuck, let us know so we can help you out. Once you've configured your proxy we'll help you test it.