AWS::Cognito::UserPoolUICustomizationAttachment

=> Search

The AWS::Cognito::UserPoolUICustomizationAttachment resource sets the UI customization information for a user pool's built-in app UI.

You can specify app UI customization settings for a single client (with a specific clientId) or for all clients (by setting the clientId to ALL). If you specify ALL, the default configuration is used for every client that has had no UI customization set previously. If you specify UI customization settings for a particular client, it no longer falls back to the ALL configuration.

• Note*

Before you create this resource, your user pool must have a domain associated with it. You can create an AWS::Cognito::UserPoolDomain resource first in this user pool.

Setting a logo image isn't supported from AWS CloudFormation. Use the Amazon Cognito SetUICustomization API operation to set the image.

=> SetUICustomization

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::Cognito::UserPoolUICustomizationAttachment",
  "Properties" : {
      "ClientId" : String,
      "CSS" : String,
      "UserPoolId" : String
    }
}

YAML

Type: AWS::Cognito::UserPoolUICustomizationAttachment
Properties: 
  ClientId: String
  CSS: String
  UserPoolId: String

Properties

The client ID for the client app. You can specify the UI customization settings for a single client (with a specific clientId) or for all clients (by setting the clientId to `ALL`).
*Required*: Yes
*Type*: String
*Minimum*: `1`
*Maximum*: `128`
*Pattern*: `[\w+]+`
*Update requires*: Replacement

=> https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement Replacement

The CSS values in the UI customization.

• Required*: No
• Type*: String
• Update requires*: No interruption

=> No interruption

The user pool ID for the user pool.
*Required*: Yes
*Type*: String
*Minimum*: `1`
*Maximum*: `55`
*Pattern*: `[\w-]+_[0-9a-zA-Z]+`
*Update requires*: Replacement

=> https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement Replacement

## Return values

### Ref

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the physicalResourceId, which is “UserPoolUICustomizationAttachment-UserPoolId-ClientId". For example:

For the Amazon Cognito user pool domain UserPoolUICustomizationAttachment-us-east-1_FAKEPOOLID-2asc123fakeclientidajjulj6bh, Ref returns the name of the UI customization attachment.

For more information about using the Ref function, see Ref.

=> Ref

Examples

Creating a new UI customization attachment for a user pool

The following example sets UI customization settings in the referenced user pool and client.

JSON

{
   "UserPoolUICustomization":{
      "Type":"AWS::Cognito::UserPoolUICustomizationAttachment",
      "Properties":{
         "UserPoolId":{
            "Ref":"UserPool"
         },
         "ClientId":{
            "Ref":"Client"
         },
         "CSS":".banner-customizable {\nbackground:
        linear-gradient(#9940B8, #C27BDB)\n}"
      }
   }
}

YAML

UserPoolUICustomization: 
  Type: AWS::Cognito::UserPoolUICustomizationAttachment 
  Properties: 
    UserPoolId: !Ref UserPool
    ClientId: !Ref Client 
    CSS: ".banner-customizable { 
      background: linear-gradient(#9940B8, #C27BDB) 
    }"