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 2 weeks ago

Available for: Business Plus plan (Legacy: Business plan)


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 Plus 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.

Custom Proxy Addon Setup and Site Publication Flow

Here's how to publish a Studio project using custom proxy.

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

1. Pre-Publication Preparation

When using custom proxy in Studio, you'll set up forwarding to the Studio subdomain (.studio.site) configured for your project.To prevent proxy domain (Studio subdomain) indexing before forwarding setup is complete, we recommend the following Studio settings:

  • Disable sitemap

  • Enable password protection
    Note: Since only the password page sitemap is created, we recommend keeping this enabled until forwarding setup is complete.

  • Enable noindex setting for password-protected pages
    Note: We recommend implementing noindex as site settings' metadata is reflected by default.

If the proxy domain (Studio subdomain) gets indexed, identical content may appear in search engines on both proxy and origin domains after forwarding setup. This might be evaluated as duplicate content, potentially affecting SEO performance.

2. Proxy Setup and Site Publication

  1. Publish Project in Studio

  2. Issue Custom Proxy Key

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 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. Proxy Verification

Verify that your website functions correctly through the proxy server.

5. 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.

3. Post-Publication Settings

Configure the following in Studio:

Then connect with Google Search Console and Apps, and register your property and sitemap.

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?