# Add Your Custom Branding to Amazon WorkSpaces Applications To create a familiar experience for your users when they stream applications, you can customize the appearance of WorkSpaces Applications with your own branding images, text, and website links, and you can choose from one of several color palettes. When you customize WorkSpaces Applications, your branding is displayed to users during application streaming sessions rather than the default WorkSpaces Applications branding. **Topics** + [ # Custom Branding Options for Amazon WorkSpaces Applications ](branding-options.md) + [ # Adding Your Custom Branding to Amazon WorkSpaces Applications ](branding-add-custom-branding.md) + [ # Specifying a Custom Redirect URL and Feedback URL in Amazon WorkSpaces Applications ](branding-specifying-feedback-URL.md) + [ # Previewing Your Custom Branding Changes in Amazon WorkSpaces Applications ](branding-previewing-changes.md) + [ # Color Theme Palettes in Amazon WorkSpaces Applications ](branding-color-themes.md) # Custom Branding Options for Amazon WorkSpaces Applications You can customize the appearance of the streaming application catalog page by using the following branding options. **Note** Custom branding is not available for the user pool sign-in portal or for the email notifications that WorkSpaces Applications sends to user pool users. | Branding element | Description | Requirements and recommendations | | --- | --- | --- | | Organization logo | Enables you to display an image that is familiar to your users. The image appears in the header of the streaming application catalog page, which is displayed to users after they sign in to WorkSpaces Applications. | File type: .png, jpg, .jpeg, or .gif Maximum dimensions: 1000 px x 500 px Maximum file size: 300 KB | | Organization website links | Enables you to display links to helpful resources for your users, such as your organization's IT support and product marketing sites. The links are displayed in the footer of the streaming application catalog page. | Maximum number of links: 3 Format (URL): https://example.com or http://example.com Maximum length (display name): 100 letters, spaces, and numbers Special characters allowed (display name): @ . / \$1 & \$1 \$1 | | Color theme | Applied to website links, text, and buttons. These colors are also applied as accents in the background for the streaming application catalog page. | Predefined themes from which to choose: 4 For information about each color theme, see [Color Theme Palettes in Amazon WorkSpaces Applications](branding-color-themes.md) later in this topic. | | Page title | Displayed at the top of the browser tab during users' application streaming sessions. | Maximum length: 200 letters, spaces, and numbers. Special characters allowed: @ . / \$1 & \$1 \$1 | | Favicon | Enables your users to recognize their application streaming site in a browser full of tabs or bookmarks. The favicon icon is displayed at the top of the browser tab for the application streaming site during users' streaming sessions. | File type: .png, .jpg, .jpeg, .gif, or .ico Maximum dimensions: 128 px x 128 px Maximum file size: 50 KB | | Redirect URL | Enables you to specify a URL to which users are redirected when they end a streaming session. | Format: https://example.com or http://example.com This URL is configured in the **Details** page for a stack when you create or edit a stack, not in the **Branding** page. | | Feedback URL | Enables you to specify a URL for a Send Feedback link, so that your users can submit feedback to the organization. If you do not specify a URL, the Send Feedback link is not displayed. Your users can still submit new portal feedback by selecting Provide New Portal Feedback, which is submitted to AWS. | Format: https://example.com or http://example.com This URL is configured in the **Details** page for a stack when you create or edit a stack, not in the **Branding** page. | # Adding Your Custom Branding to Amazon WorkSpaces Applications To customize WorkSpaces Applications with your organizational branding, use the WorkSpaces Applications console to select the stack to customize, and then add your branding. If you want to choose your organization logo or favicon from your Amazon S3 buckets, make sure that your Amazon S3 bucket content is not encrypted using keys that you manage (Customer Managed Keys). Amazon S3 buckets configured to use server-side encryption with customer-provided encryption keys (SSE-C) are not supported for organization logo and favicon. If you require encryption at rest for your Amazon S3 objects, server-side encryption with Amazon S3-managed encryption keys (SSE-S3) is an option for organization logo and favicon. **To add your custom branding to WorkSpaces Applications** 1. Open the WorkSpaces Applications console at [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home). 1. In the left pane, choose **Stacks**. 1. In the stack list, select the stack to customize with your branding. 1. Choose **Branding**, **Custom**. 1. For **Application catalog page**, customize how the streaming application catalog page appears to users after they sign in to WorkSpaces Applications. 1. For **Organization logo**, do either of the following: + Either enter the Amazon S3 URI that represents the organization logo, or choose **Browse S3** to navigate to your Amazon S3 buckets and find the organization logo. + If you already uploaded a organization logo and want to view it, choose **View**. You can change it by entering another Amazon S3 URI that represents the organization logo, or choose **Browse S3** to find another organization logo. 1. For **Organization website links**, specify up to three website links to display in the page footer. For each link, choose the **Add Link **button, and then enter a display name and URL. To add more links, repeat these steps for each link to add. To remove a link, choose the **Remove **button under the link URL. 1. For **Color theme**, choose the colors to use for your website links, body text, and buttons, and as an accent for the page background. For information about each color theme, see [Color Theme Palettes in Amazon WorkSpaces Applications](branding-color-themes.md) later in this topic. 1. For **Browser tab**, customize the page title and icon to display to users at the top of their browser tab during streaming sessions. 1. For **Page title**, enter the title to display at the top of the browser tab. 1. For **Favicon**, do either of the following: + Enter the Amazon S3 URI that represents the favicon, or choose **Browse S3** to navigate to your Amazon S3 buckets and find the favicon. + If you already uploaded a favicon and want to view it, **choose View**. Or, you can change it by entering another Amazon S3 URI that represents the favicon, or choose **Browse S3** to find another favicon. 1. Do either of the following: + To apply your branding changes, choose **Save**. When users connect to new streaming sessions that are launched for the stack, your branding changes are displayed. **Note** WorkSpaces Applications retains the custom branding changes that you save. If you save your custom branding changes, but then choose to restore the WorkSpaces Applications default branding, your custom branding changes are saved for later use. If you restore the WorkSpaces Applications default branding and decide later to reapply your custom branding, choose **Custom**, **Save**. In this case, the most recently saved custom branding is displayed to your users. + To discard your branding changes, choose **Cancel**. When prompted to confirm your choice, choose **Confirm**. If you cancel your changes, the most recently saved branding is displayed to your users. # Specifying a Custom Redirect URL and Feedback URL in Amazon WorkSpaces Applications You can specify a URL to which your users are redirected when they end their streaming session, as well as a URL where your users can submit feedback. By default, WorkSpaces Applications displays a **Send Feedback** link that enables users to submit feedback to AWS about the quality of their application streaming session. To enable your users to submit feedback to a site that you specify, you can provide a custom feedback URL. You can specify the redirect URL and feedback URL when you create a new stack or edit the details for an existing stack. For more information, see [Create a Stack in Amazon WorkSpaces Applications](set-up-stacks-fleets-install.md). # Previewing Your Custom Branding Changes in Amazon WorkSpaces Applications You can preview how your branding changes will appear to your users by applying your branding changes to a test stack before you apply them to a production stack, and then creating a streaming URL for the test stack. After you validate your branding changes, you can them deploy them to your production stack. For information, see [Step 2: Provide Access to Users](getting-started.md#getting-started-access) in *Getting Started with Amazon WorkSpaces Applications*. # Color Theme Palettes in Amazon WorkSpaces Applications When you choose a color theme, the colors for that theme are applied to the website links, text, and buttons in your streaming application catalog page. A color is also applied as an accent in the background for your streaming application catalog page. For each color in a color theme palette, the hex value is also noted. **Topics** + [ ## Red ](#color-theme-red) + [ ## Light Blue ](#color-theme-lightblue) + [ ## Blue ](#color-theme-blue) + [ ## Pink ](#color-theme-pink) ## Red The following colors are applied when you select the red color theme. ![\[red icon (#d51900)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-d51900.png)    **Red (\$1d51900)** – Used for buttons and website links. ![\[white icon (#faf9f7)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-faf9f7.png)    **White (\$1faf9f7)** – Used as a background accent. ![\[dark grey icon (#404040)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-404040.png)    **Dark grey (\$1404040)** – Used for the body text and in the progress spinner. When you choose the red color theme, the website links, body text, and background accent appear in your streaming application catalog page as follows. ![\[Red color theme applied to application catalog page\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Red-AppCatalogPage2.png) ## Light Blue The following colors are applied when you select the light blue color theme: ![\[light blue icon (#1d83c2)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-1D83C2.png)    **Light blue (\$11d83c2)** – Used for buttons and website links. ![\[white icon (#f6f6f6)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/colore-theme-f6f6f6.png)    **White (\$1f6f6f6)** – Used as a background accent. ![\[dark grey icon (#333333)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-333333.png)    **Dark grey (\$1333333)** – Used for the body text and in the progress spinner. When you choose the light blue color theme, the website links, body text, and background accent appear in your streaming application catalog page as follows. ![\[Light blue color theme applied to application catalog page\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/LightBlue-AppCatalogPage2.png) ## Blue The following colors are applied when you select the blue color theme: ![\[blue icon (#0070ba)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-0070ba.png)    **Blue (\$10070ba)** – Used for website links. ![\[white icon (#ffffff)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-ffffff.png)    **White (\$1ffffff)** – Used as a background accent. ![\[light green icon (#8ac53e)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-8ac53e.png)    **Light green (\$18ac53e)** – Used for buttons. ![\[grey icon (#666666)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-666666.png)    **Grey (\$1666666)** – Used for the body text and in the progress spinner. When you choose the blue color theme, the website links, body text, and background accent appear in your streaming application catalog page as follows. ![\[Blue color theme applied to application catalog page\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Blue-AppCatalogPage2.png) ## Pink The following colors are applied when you select the pink color theme: ![\[pink icon (#ec0069)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-ec0069.png)    **Pink (\$1ec0069)** – Used for website links. ![\[white icon (#ffffff)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-ffffff.png)    **White (\$1ffffff)** – Used as a background accent. ![\[blue icon (#3159a2)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-3159A2.png)    **Blue (\$13159a2)** – Used for buttons. ![\[dark grey icon (#333333)\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/color-theme-333333.png)    **Dark grey (\$1333333)** – Used for the body text and in the progress spinner. When you choose the pink color theme, the website links, body text, and background accent appear in your streaming application catalog page as follows. ![\[Pink color theme applied to application catalog page\]](http://docs.aws.amazon.com/appstream2/latest/developerguide/images/Pink-AppCatalogPage.png)