Available on: Business Plus plan and above (legacy plans: Business plan and above)
What is Custom Proxy?
Custom Proxy is an add-on for websites that you can purchase for projects on the Business Plus plan or above. It lets you integrate your Studio.Design site with an existing hosting environment such as AWS, Cloudflare, or Google Cloud, giving you fine-grained control over headers, authentication, and delivery.
To use it, your hosting platform adds the proxy key issued by Studio.Design to client requests and forwards them to your Studio.Design site.
Learn more: For details on what Custom Proxy is and the benefits it offers, check out this article on the Studio.Design blog as well.
Please note:
Custom Proxy is an advanced option that requires you to prepare and configure your own hosting environment.
Our chat support covers the standard forwarding setup described in this article and in the troubleshooting guide.
Support and consultation on the details of reverse proxies and their implementation are available only on select Enterprise plans. Feel free to contact us for details.
Use cases
1. Bring multiple websites together under a single domain
By adjusting your proxy settings, you can route each subdirectory to a different server. This lets you display a site built in Studio.Design as part of your main site.
For example, you could serve /hello from your Studio.Design site, /blog from another server, and the main page from a custom-built site.
2. Run your own processing before requests
You can insert your own processing, such as authentication, before requests are sent to your Studio.Design site.
3. Use your company's infrastructure
You can deliver traffic through your company's existing infrastructure, so your site runs in line with internal policies.
Technical requirements
For technical requirements and limitations, see the article below.
Important: forwarding the /_nuxt/ directory is required
For Studio.Design pages to render, requests under the
/_nuxt/directory must be forwarded to Studio.Design. This path can't be changed.If you have your own Nuxt.js site behind the proxy and you can't change the
/_nuxt/path name on that site, you won't be able to use Custom Proxy.This is because when multiple services use the same
/_nuxt/path, requests can't be routed to the right destination, and Studio.Design won't work properly.
Notes on using a CDN or reverse proxy
If you want to place a CDN or reverse proxy in front of your published Studio.Design site, the Custom Proxy add-on is required.
Projects that use a CDN or reverse proxy without the add-on aren't supported, and we can't guarantee that publishing or other features will work as expected.
Pricing and payment
Custom Proxy is purchased separately from your project's plan. It costs ¥39,800 per month (tax included) and is billed monthly.
For details on billing cycles and more, see About add-ons and payment.
How to set up the Custom Proxy add-on
Here's how to publish a Studio.Design project using Custom Proxy.
(1) Prepare before publishing
Custom Proxy uses your Studio.Design subdomain (.studio.site) as the origin.
If search engines index that subdomain before you finish setting up forwarding on your proxy server, the content may be treated as duplicate content.
To avoid a negative impact on SEO, we recommend the following settings beforehand.
Turn off your sitemap
Turn on password protection
Note: With password protection on, only a sitemap for the password page is generated, so keep this setting enabled until forwarding is set up.
Turn on noindex for the password-protected page
Note: By default, the site's metadata is used as-is, so we recommend adding noindex.
(2) Add the Custom Proxy add-on
In the dashboard for your project, open [Plan & Billing].
Open [Add-ons].
Click [Add] on the Custom Proxy add-on.
A payment confirmation screen appears. Review the add-on charge and the notes, then click [Confirm payment].
(3) Issue a proxy key
In the dashboard for your project, open [Settings].
Select [Custom] in the menu on the left.
Click [Settings] for Custom Proxy.
Register your domain name, and a proxy key will be issued.
(4) Set up forwarding on your proxy server
Required settings
Item: What to set
Origin domain: your Studio.Design subdomain (XXXX.studio.site)
Header name:
x-studio-proxy-keyValue: the proxy key issued in Studio.Design
Other settings
These vary by service, so refer to the article below and configure your setup to meet the requirements.
Support with detailed configuration is available on select Enterprise plans. Feel free to get in touch.
How to check your subdomain
In the dashboard for your project, open [Settings].
Select [General] in the menu on the left.
Click [Settings] under [Publish status] to open the publish panel.
If you've already set up a custom domain, click [Studio domain settings] to open the settings screen for your Studio.Design subdomain.
You can update or set your subdomain even with a custom domain in place, and updating it won't disconnect your custom domain.
Enter text in the subdomain field and click the save button to save your Studio.Design subdomain.
(5) Adjust settings after publishing
Update the following settings in Studio.Design.
Turn on your sitemap
Turn off password protection
Then connect Google Search Console through Apps, and register your property and sitemap.
How to stop (cancel) the add-on
Important: about stopping add-ons
Downgrading your project's plan does not automatically stop the add-on. Be sure to stop the add-on before downgrading.
Stopping an add-on doesn't cancel it right away. You can keep using it until your next renewal date, and the cancellation takes effect on that date. Because of this, no refund is issued for the remaining time between when you stop it and the renewal date.
In the dashboard for your project, open [Plan & Billing].
Open [Add-ons].
Click [Stop] on the Custom Proxy add-on.
For details on add-on billing cycles, payments, and viewing receipts, see About add-ons and payment.
How to resume the add-on
After stopping an add-on, you can resume your subscription any time before the next renewal date, when the cancellation takes effect.
In the dashboard for your project, open [Plan & Billing].
Open [Add-ons].
Click [Resume] on the Custom Proxy add-on.
Note: After the renewal date, you can't resume — you'll need to subscribe again by adding the add-on from scratch.
nuxt