Available on: Business Plus plan and above (formerly: Business plan and above)
What is Custom Proxy?
Custom Proxy is a website add-on you can purchase separately for projects on the Business Plus plan or higher. It lets you integrate your Studio.Design site with existing hosting environments like AWS, Cloudflare, or Google Cloud, giving you fine-grained control over headers, authentication, and delivery.
When in use, your hosting platform attaches a Studio.Design-specified proxy key to client requests and forwards them to your Studio.Design site.
Important:
Custom Proxy is an advanced option that requires you to prepare and configure your own hosting environment.
Our chat support team can help based on the standard forwarding setup described in this article and the troubleshooting guide.
Detailed support and consultation on reverse proxy implementation is available only on select Enterprise plans. Feel free to contact us for details.
Use cases
1. Combining multiple websites under a single domain
By adjusting your proxy settings, you can route different subdirectories to different servers. This lets you display a Studio.Design site as part of your main website.
For example, you could set /hello to a Studio.Design site, /blog to a site on another server, and your main page to a custom-built site.
2. Custom processing before requests
You can run your own processing — such as authentication — before requests reach your Studio.Design site.
3. Using corporate infrastructure
You can route traffic through your company's existing infrastructure, allowing you to run your site in line with internal policies.
Technical requirements
For technical requirements and limitations, please see the article below.
Important: Forwarding the /_nuxt/ directory is required
Studio.Design's page rendering requires requests under the
/_nuxt/directory to be forwarded to Studio.Design, and this path cannot be changed.If you have a custom site built with Nuxt.js behind the same proxy, and that site can't change its
/_nuxt/path either, then Studio.Design's Custom Proxy cannot be used.This is because when multiple services share the same
/_nuxt/path, the proxy can't tell them apart, and Studio.Design will not work correctly.
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, you must subscribe to the Custom Proxy add-on.
Projects that place a CDN or reverse proxy in front of the site without the add-on are not supported, and we do not guarantee that publishing or other operations will work properly.
Pricing and payment
Custom Proxy is available as an add-on, purchased separately from your project's plan. It costs ¥39,800/month (tax included) and is billed monthly.
For billing cycle details, 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) Preparation before publishing
Studio.Design's Custom Proxy uses your Studio.Design subdomain (.studio.site) as the origin.
If that subdomain gets indexed by search engines before you finish setting up forwarding on your proxy server, it may be treated as duplicate content.
To avoid hurting your SEO, we recommend doing the following beforehand:
Disable the sitemap
Enable password protection
* Since only a sitemap for the password page will be generated, keep this enabled until forwarding is complete.
Enable noindex on the password protection page
* By default, the site settings metadata is used as-is, so we recommend adding noindex.
(2) Add the Custom Proxy add-on
Open [Plan & Billing] in your project's dashboard.
Open [Add-ons].
Click [Add] on the Custom Proxy add-on.
A payment confirmation screen will appear. Review the add-on charges and notes, then click [Confirm payment].
(3) Generate a proxy key
Open [Home] in your project's dashboard.
Open [Project Settings].
Click [Settings] under Custom Proxy.
Register your domain name to generate a proxy key.
(4) Set up forwarding on your proxy server
Required fields
Field: Setting
Origin domain: Your Studio.Design subdomain (XXXX.studio.site)
Header name:
x-studio-proxy-keyValue: The proxy key generated in Studio.Design
Other fields
These vary by service, so please refer to the article below and configure them to meet the requirements.
Detailed configuration support is available on select Enterprise plans. Feel free to get in touch.
How to check your subdomain
Open [Home] in your project's dashboard.
Open [Project Settings].
Click [Publish Settings] to open the publish panel.
If you have a custom domain set up, click [Studio.Design Domain Settings] to open the Studio.Design subdomain settings.
You can update or change your subdomain even when a custom domain is connected, and doing so won't disconnect the custom domain. Just enter a value in the subdomain field and click Save to update your Studio.Design subdomain.
(5) Settings after publishing
In Studio.Design, do the following:
Enable the sitemap
Disable password protection
Then connect to Google Search Console via Apps, and register your property and sitemap.
How to cancel the add-on
Important: About canceling add-ons
Downgrading your project plan does not automatically cancel the add-on. Please cancel the add-on before downgrading.
Canceling the add-on doesn't take effect immediately. You can keep using it until your next renewal date, when cancellation is completed. No refund is issued for any remaining time between cancellation and renewal.
Open [Plan & Billing] in your project's dashboard.
Open [Add-ons].
Click [Cancel] on the Custom Proxy add-on.
For details on add-on billing, payment cycles, and viewing receipts, see About add-ons and payment.
How to resume the add-on
After canceling, you can resume your add-on subscription any time before the next renewal date (when cancellation takes effect).
Open [Plan & Billing] in your project's dashboard.
Open [Add-ons].
Click [Resume] on the Custom Proxy add-on.
* Once the renewal date has passed, you'll need to re-subscribe instead of resuming. Please add the add-on again.
nuxt