Configure the Launchpad name and icon

Please note that this is considered Advanced Configuration for Atlas and requires Microsoft 365 Tenant Administrator permissions. Ownership of the workspace is not sufficient.

You can configure the Launchpad to better match your brand by changing the icon and label for the element. Additionally you can configure different icons and labels for different languages if you wish.

In this article:

• Access the Tenant Properties page
• Configure the Launchpad settings
• Configure the Launchpad as "icon only"
• Still need help?

Access the Tenant Properties page

1. Navigate to the Atlas Configuration workspace. This workspace can be found by searching for "configuration" in Atlas ConneX, or by manually navigating to the site at /sites/atlasconfiguration in your Microsoft 365 tenant.
2. Go to Site contents in the top right menu:
   
3. Click on the Site Pages library (at the bottom of this list) to open it, find the page Tenant-Properties.aspx and open the page. If you see the following message then you do not have sufficient permissions to make the changes and will need to speak to an Administrator:
   
4. If you have sufficient permissions then you'll see something more like this:
   

Configure the Launchpad settings

Once you have accessed the Tenant Properties page as above, follow these steps to update the Launchpad configuration:

1. Scroll down or use the Search box in the page to find the item Atlas.Launchpad.Settings:
   
2. Select this item then click Edit at the top of the list. A panel will open on the right hand side showing the configuration of this property:
   
3. You can now make changes to this configuration, but take care when making changes. Before making changes copy the full VALUE text from the panel and paste it into a text editor - even just Notepad. You could also save a copy of this in case you need to revert your changes.
4. In the copied text we can see that the configuration can be set per language - this refers to the display language of the web browser viewing the site, which usually in turn is determined by the language settings of the device being used. Configuration for each language is determined by the following (highlighted in green):
   
5. To change the label for an existing language, simply change "Launchpad" in the text supplied - in the example highlighted above denoted by "label": "Launchpad" to whatever you prefer e.g. "label": "Applications". To change the icon, take the same approach but you need to supply the name of a Fluent UI Icon. You can find a reference for these icon names here: Flicon - Fluent UI Icon Search - hover over the desired icon to see the name. Please note that if you choose the icon "NoIcon" to hide it, this will also be hidden on mobile devices. There is no text element for the Launchpad on mobile so users may not realise it is available.
6. To add another language configuration, you need to add another instance of the language configuration at the end of the file. After the last default setting in the file, add a comma after the brace but before the square bracket e.g. },]}, then copy one of the existing languages (for example copy exactly the text highlighted in the image above) and paste that after the comma but before the square bracket.
7. Now you'll have a duplicate language, so you need to change the language to the correct code for example de for German or pt-br for Brazilian Portuguese, set the label you want to use for that language, and change the icon to if required.
8. From Atlas 5.0, to change the Launchpad to a minimalist style, you will need to add a small value to the end of the instance of the enabled language configuration string. Please add, "onlyIcon":true.
   e.g.  {"language":"en-US","label":"Launchpad ","icon": "atlas-rocket-svg", "default":true,"onlyIcon":true}
9. Once you have finished making your changes copy the whole text back into the VALUE field in the panel from step 2. Click Save at the bottom of the panel to save your changes.

Please note that these changes may not be seen by users until their cache clears. You can let this happen automatically, or users can manually clear their cache by following these steps: How to completely clear Atlas caches

Configure the Launchpad as "icon only" (Atlas 5.0+)

If you prefer, you can have your Launchpad as just an icon without any text. This is mentioned in the steps above, but I am repeating it here for ease of finding the information. This requires Atlas 5.0 or later.

To change the Launchpad to a minimalist style, you will need to add a small value to the end of the instance of the enabled language configuration string. Please add , "onlyIcon":true including the preceding comma - see example below:

{"language":"en-US","label":"Launchpad ","icon": "atlas-rocket-svg", "default":true, "onlyIcon":true}

If you want the icon hidden for all languages you'll need to add this to every language string.

Still need help?

If you still need assistance with any of the above please contact support or your CSM.