Skip to main content
All CollectionsHostingAdd-ons
Setting Up a Custom Proxy
Setting Up a Custom Proxy

Integrate your Studio site with existing hosting providers or infrastructure using a custom proxy.

Morota avatar
Written by Morota
Updated over a week ago

Applicable Plans: Business


Note:

  • This is an advanced option that requires you to provide your own hosting platform.

  • Due to the advanced nature of this feature, our chat support cannot provide assistance beyond what is covered in this article.

What is a Custom Proxy?

A custom proxy is an add-on that you can include based on your website’s needs. This feature is available for projects on the Business plan with a separate contract.

Using this feature, you can integrate your Studio site with existing hosting providers or infrastructure. This allows full control over headers, authentication, and delivery. Hosting platforms like AWS, Cloudflare, and Google Cloud all support proxy hosting, making integration possible.

How Custom Proxies Work

On your hosting platform, this feature works by attaching a proxy key specified by Studio to client requests and forwarding them to your Studio site.

Image of how custom proxy works

Pricing and Payment

A custom proxy is an additional contract separate from your plan. The fee is $290 per month, billed monthly. For details on the payment cycle, refer to Add-on Overview.

Use Cases

Here are some use cases for the custom proxy feature:

  1. Integrate Multiple Websites into a Single Domain

    By rewriting the proxy, you can direct different paths to different origins. For example, /hello can point to one Studio site, /blog to another site, and the main index to a custom-built site.

  2. Custom Processing Before Requests

    You can add custom processing such as authentication before sending requests to the Studio site.

  3. Using Corporate Infrastructure

    In large enterprises, ensure that traffic is served from approved corporate infrastructure.

How to Set Up a Custom Proxy

Tip: Payment confirmation, as well as adding and configuring headers, can only be done by accounts with owner right or higher.

1. Open [Plans & Billing] on the Dashboard

Open [Plans & Billing] for the project where you want to add custom headers.

2. Add the Custom Proxy Add-on to Your Project

Click [Get add-on] for the custom proxy.

Screenshot: Starting to use a custom proxy.

On the payment confirmation screen, review the add-on billing amount and notes, then click [Buy now].

Screenshot: Starting to use a custom proxy.

3. Configure the Custom Proxy

Note: If your site is live, changes will be reflected immediately upon addition.

Open the project [Home] and copy the custom proxy [Proxy Key].

Screenshot: Setting up a custom proxy.

If you are using the sitemap.xml or RSS features, click [Settings] and set the domain.

Screenshot: Setting up a custom proxy.

4. Set Up Forwarding

On your hosting platform, set up forwarding to the Studio subdomain (ending in .Studio.site) that is associated with your destination project. During this setup, make sure to add the header with the key name x-studio-proxy-key and use the string obtained in Step 3. For specific instructions on how to configure this on your platform, please consult your hosting service provider.

How to Check Your Subdomain:

You can find your subdomain (ending in .Studio.site) in the project’s publishing panel.

Screenshot: Subdomain Settings Screen.

If you have a custom domain set up, click [Studio Domain Settings] to display the subdomain settings screen.

You can update and configure your subdomain even when a custom domain is set. Updating the subdomain will not disconnect your custom domain. Simply enter the desired string in the subdomain input field and click the save button to store your Studio subdomain.

Screenshot: Opening the Subdomain Settings Screen.

How to Disable the Custom Proxy Add-on

Tip: Ongoing settings will be deleted once the add-on contract ends.

1. Open [Plans & Billing] on the Dashboard

Open [Plans & Billing] for the project where you want to stop using the custom proxy add-on.

2. Disable the Custom Proxy Add-on

Click [Disable add-on] for the custom proxy, review the confirmation screen, and then click [Disable add-on].

Screenshot: Stopping the use of an add-on.
Did this answer your question?