From 595cb5fd257a287f850c73510fcd6625c4aa360e Mon Sep 17 00:00:00 2001
From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com>
Date: Tue, 19 Aug 2025 09:38:10 +0200
Subject: [PATCH 1/4] feat (iam): org alias
---
macros/iam/login-member.mdx | 3 +-
.../how-to/set-organization-alias.mdx | 34 +++++++++++++++++++
2 files changed, 36 insertions(+), 1 deletion(-)
create mode 100644 pages/organizations-and-projects/how-to/set-organization-alias.mdx
diff --git a/macros/iam/login-member.mdx b/macros/iam/login-member.mdx
index f57bb0a44e..43dee8b0d2 100644
--- a/macros/iam/login-member.mdx
+++ b/macros/iam/login-member.mdx
@@ -9,7 +9,8 @@ macro: login-member
3. Enter the Organization ID and click **Continue**.
- When you are added to an Organization as a Member, a Scaleway account is automatically created for you. An Organization administrator must provide a username, email and Organization ID for you to log in.
+ - When you are added to an Organization as a Member, a Scaleway account is automatically created for you. An Organization administrator must provide a username, email and Organization ID for you to log in.
+ - If your Organization admin provided a [link to connect directly](/organizations-and-projects/how-to/set-organization-alias) to your Organization, you can disregard step 3.
4. Enter the username given to you by your Organization's Owner or administrator.
5. Select an authentication method between **Send code** and **Enter password**.
diff --git a/pages/organizations-and-projects/how-to/set-organization-alias.mdx b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
new file mode 100644
index 0000000000..e622cca730
--- /dev/null
+++ b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
@@ -0,0 +1,34 @@
+---
+title: How to set an Organization alias
+description: This page shows you how to set up your Organization's alias
+tags: organization alias
+dates:
+ validation: 2025-08-14
+ posted: 2025-08-14
+---
+
+An alias is a string of characters used to identify the Organization during member login. Aliases can be used as an alternative to the Organization ID to make memorization and access easier for members.
+
+
+ Keep in mind that:
+ - An alias must contain between 2 and 32 characters
+ - Aliases must be composed of lower case letters from A to Z and cannot include accents or digits
+ - Each alias is unique value at Scaleway, meaning that no two Organizations can have the same alias
+ - Currently, any update to your alias must be made via [support ticket](https://console.scaleway.com/support).
+
+
+
+This will also affect the URL! Examples after 1st member login step:
+- I have no alias => account.scaleway.com
+- I have "dundermifflin" as my org alias => dundermifflin.account.scaleway.com
+
+1. Go to the [Organization settings page](https://console.scaleway.com/settings/organization/information).
+2. Click **Add** under **Organization alias** in the **Organization Information** section. A pop-up displays.
+3. Enter an alias in the designated box.
+4. Click **Confirm**. Your Organization alias displays in the Organization Information section.
+5. Navigate to `.account.scaleway.com/`, replacing `` with your alias to test.
+
+You can now share this link with members so they [can log in directly](/iam/how-to/log-in-as-a-member) to your Organization without filling out the Organization ID.
+
+
+
From 75d7b39e46fe5f0859c23e3b20164361510b07f0 Mon Sep 17 00:00:00 2001
From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com>
Date: Tue, 19 Aug 2025 09:46:48 +0200
Subject: [PATCH 2/4] feat(iam): message box
---
menu/navigation.json | 4 ++++
.../how-to/set-organization-alias.mdx | 7 +------
2 files changed, 5 insertions(+), 6 deletions(-)
diff --git a/menu/navigation.json b/menu/navigation.json
index e52dc4edcf..eee9ab958f 100644
--- a/menu/navigation.json
+++ b/menu/navigation.json
@@ -600,6 +600,10 @@
"label": "Manage Organization quotas",
"slug": "manage-quotas"
},
+ {
+ "label": "Set an Organization alias",
+ "slug": "set-organization-alias"
+ },
{
"label": "Create a Project",
"slug": "create-a-project"
diff --git a/pages/organizations-and-projects/how-to/set-organization-alias.mdx b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
index e622cca730..40565183b3 100644
--- a/pages/organizations-and-projects/how-to/set-organization-alias.mdx
+++ b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
@@ -9,7 +9,7 @@ dates:
An alias is a string of characters used to identify the Organization during member login. Aliases can be used as an alternative to the Organization ID to make memorization and access easier for members.
-
+
Keep in mind that:
- An alias must contain between 2 and 32 characters
- Aliases must be composed of lower case letters from A to Z and cannot include accents or digits
@@ -17,11 +17,6 @@ An alias is a string of characters used to identify the Organization during memb
- Currently, any update to your alias must be made via [support ticket](https://console.scaleway.com/support).
-
-This will also affect the URL! Examples after 1st member login step:
-- I have no alias => account.scaleway.com
-- I have "dundermifflin" as my org alias => dundermifflin.account.scaleway.com
-
1. Go to the [Organization settings page](https://console.scaleway.com/settings/organization/information).
2. Click **Add** under **Organization alias** in the **Organization Information** section. A pop-up displays.
3. Enter an alias in the designated box.
From 0ad8fab7caa802b545d19ce9ef292109763cb736 Mon Sep 17 00:00:00 2001
From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com>
Date: Thu, 21 Aug 2025 15:56:42 +0200
Subject: [PATCH 3/4] fix(iam): review ro
Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com>
---
.../how-to/set-organization-alias.mdx | 3 ---
1 file changed, 3 deletions(-)
diff --git a/pages/organizations-and-projects/how-to/set-organization-alias.mdx b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
index 40565183b3..1fd39aae2c 100644
--- a/pages/organizations-and-projects/how-to/set-organization-alias.mdx
+++ b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
@@ -24,6 +24,3 @@ An alias is a string of characters used to identify the Organization during memb
5. Navigate to `.account.scaleway.com/`, replacing `` with your alias to test.
You can now share this link with members so they [can log in directly](/iam/how-to/log-in-as-a-member) to your Organization without filling out the Organization ID.
-
-
-
From 9f5af8226d40654c3484661d81e6c3dd2f581377 Mon Sep 17 00:00:00 2001
From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com>
Date: Thu, 21 Aug 2025 17:23:44 +0200
Subject: [PATCH 4/4] feat(acc): review ro
---
.../how-to/set-organization-alias.mdx | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/pages/organizations-and-projects/how-to/set-organization-alias.mdx b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
index 1fd39aae2c..9640849dcb 100644
--- a/pages/organizations-and-projects/how-to/set-organization-alias.mdx
+++ b/pages/organizations-and-projects/how-to/set-organization-alias.mdx
@@ -9,6 +9,12 @@ dates:
An alias is a string of characters used to identify the Organization during member login. Aliases can be used as an alternative to the Organization ID to make memorization and access easier for members.
+
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+
+
Keep in mind that:
- An alias must contain between 2 and 32 characters