> For the complete documentation index, see [llms.txt](https://docs.rewst.help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rewst.help/rewst-documentation/documentation/apps/app-domains.md).

# App domains

## <mark style="color:$danger;">Default subdomain structure</mark>

<mark style="color:$danger;">By default, all apps hosted on Rewst are assigned a subdomain under</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">`*.rew.st`</mark><mark style="color:$danger;">. This means your app's URL will be in the format</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">`your-app-name.rew.st`</mark><mark style="color:$danger;">. Rewst takes care of the underlying infrastructure, allowing you to focus on building and deploying your apps.</mark>

### <mark style="color:$danger;">Custom subdomains</mark>

#### <mark style="color:$danger;">Initial setup</mark>

<mark style="color:$danger;">When you first create your app, Rewst provides an option for a custom subdomain. This custom subdomain follows the pattern</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">`<org-slug>-<custom-subdomain>.rew.st`</mark><mark style="color:$danger;">.</mark>

* <mark style="color:$danger;">`<org-slug>`</mark><mark style="color:$danger;">: This is your organization's unique identifier. You can update it in the Rewst Settings page for your organizations.</mark>
* <mark style="color:$danger;">`<custom-subdomain>`</mark><mark style="color:$danger;">: You can choose a custom subdomain for your app during the creation process.</mark>

<figure><img src="https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/qF6u1Wbcq3fKgupbux4f/image.png" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$danger;">Update the organization slug</mark>

<mark style="color:$danger;">URLs on your App Builder pages are generated based on your organization slug within Rewst. If you wish to update your organization's slug:</mark>

1. <mark style="color:$danger;">Navigate to</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Settings > Organization**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">in the left side menu of your Rewst platform. Do this for the organization you're using for your app.</mark>
2. <mark style="color:$danger;">Click</mark> ![](https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/Utb98dSQnjc29YWzYlto/Screenshot%202026-01-22%20at%2010.01.13%E2%80%AFAM.png) <mark style="color:$danger;">to open the display options list.</mark>
3. <mark style="color:$danger;">Check the</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Org Slug**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">column.</mark> \
   ![](https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/XdmbeIyB2O5otjxcwD62/Screenshot%202026-01-22%20at%2010.01.08%E2%80%AFAM.png)
4. <mark style="color:$danger;">Locate the organization slug field for your organization.</mark>
5. <mark style="color:$danger;">Click</mark> ![](https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/VaeVaRLldoccasrAyOQf/Screenshot%202026-01-22%20at%2010.02.59%E2%80%AFAM.png) <mark style="color:$danger;">to the far right of your organization to enable editing.</mark>
6. <mark style="color:$danger;">Update the org slug as needed.</mark>
7. <mark style="color:$danger;">Click</mark> ![](https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/cReJuDfjH5EBXuCtT1EE/Screenshot%202026-01-22%20at%2010.03.32%E2%80%AFAM.png) <mark style="color:$danger;">to save.</mark>
8. <mark style="color:$danger;">Changes will take effect immediately.</mark>

<figure><img src="https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/BChCgmX7YhXwrP1tv6E9/Screenshot%202026-01-22%20at%2010.04.33%E2%80%AFAM.png" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$danger;">Update the custom subdomain</mark>

<mark style="color:$danger;">To modify the custom subdomain of your app:</mark>

1. <mark style="color:$danger;">Open your app in App Builder.</mark>
2. <mark style="color:$danger;">Look for the option to update the subdomain.</mark>
3. <mark style="color:$danger;">Enter your desired custom subdomain.</mark>
4. <mark style="color:$danger;">Confirm the changes.</mark>

<figure><img src="https://content.gitbook.com/content/h0G0em3PH6aDfPoI5XpN/blobs/8P0a1asP8Dv9ytaP9ePQ/Screenshot%202026-03-06%20at%2010.02.27%E2%80%AFAM.png" alt=""><figcaption></figcaption></figure>

#### <mark style="color:$danger;">Example:</mark>

<mark style="color:$danger;">Let's say your organization slug is</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">`myorg`</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">and your custom subdomain is</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">`app1`</mark><mark style="color:$danger;">. Your app's URL would be</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">`myorg-app1.rew.st`</mark><mark style="color:$danger;">.</mark>

### <mark style="color:$danger;">Why customize subdomains?</mark>

<mark style="color:$danger;">Custom subdomains provide a branded and personalized touch to your apps. It makes them easily identifiable and memorable for your users. Whether you're representing a business, project, or personal endeavor, a custom subdomain adds a professional touch to your online presence.</mark>

### <mark style="color:$danger;">Custom domain support and creation guidelines</mark>

<mark style="color:$danger;">Rewst offers custom domain support, allowing you to use your own domain name for your Rewst-hosted apps. Ensure that your custom subdomains comply with Rewst's guidelines and any applicable legal or branding standards. Abusive or inappropriate subdomains may be subject to action by Rewst.</mark>

{% hint style="info" %}
If you have suggestions for new App Builder features, or general feedback about your experience using this part of Rewst, submit your thoughts to our [Canny](https://rewst.canny.io/app-builder).&#x20;
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rewst.help/rewst-documentation/documentation/apps/app-domains.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.