---
schema_version: "1"
id: 55115ce2cc449dcf338f4820ebf140d026cd91c716b6c4ca4e562c3a7c4cab83
title: Customize Fonts with the
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/service_sdk_ios/customize_fonts.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/customize_fonts.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 7445d9c298214086c21bd1da8f1b8b83403cc3b94b60c3f8bbba0f94ea4bf0a4
description: "There are three customizable font settings used throughout the UI: SCFontWeightLight, SCFontWeightRegular, SCFontWeightBold."
---
# Customize Fonts with the

There are three customizable font settings used throughout the UI: SCFontWeightLight, SCFontWeightRegular, SCFontWeightBold.

![Important](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/images/icon_note_important.png)

#### Important

The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to [Messaging for In-App and Web](https://help.salesforce.com/s/articleView?id=service.miaw_intro_landing.htm&type=5&language=en_US) before that date. Messaging offers many of the [chat features that you](https://help.salesforce.com/s/articleView?id=service.miaw_chat_vs_messaging.htm&type=5&language=en_US) love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in [Help](https://help.salesforce.com/s/articleView?id=001790618&type=1&language=en_US).

You can customize three font settings used throughout the Service Chat SDK interface:

| Font Setting | Default Value | Samples Uses in the SDK |
| --- | --- | --- |
| SCFontWeightLight | Helvetica Neue - Light | Knowledge article cell summary, Case Management field text, Case Management submit success view, content of error messages |
| SCFontWeightRegular | Helvetica Neue | Navigation bar, Chat text, Knowledge data category cell in detail view, Knowledge "show more" article footer, Knowledge "show more" button cell |
| SCFontWeightBold | Helvetica Neue - Semibold | Knowledge category headers, Knowledge article cell title, Case Management field labels, Case Management submit button, title of error messages |

To configure your app to use different fonts:

1. Add new fonts to your Xcode project.
    
    Any new fonts must be added as a resource to your Xcode project. When adding, be sure to select **Copy items if needed**.
2. Add new fonts to your project target.
    
    For each new font, add it to your project target under **Target Membership**.
    
    ![Target Membership for font](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/images/ios-font-customization-1.png)
3. Add the font to your app's Info.plist.
    
    You'll need to add all new fonts into a string array. Each string element of the array must be the name of each font resource file.
    
    If you're viewing your Info.plist as a **Property List**, add an Array named **Fonts provided by application**.
    
    If you're viewing your Info.plist as **Source Code**, add an array named UIAppFonts. For example:
    
    <key\>UIAppFonts</key\>
      <array\>
        <string\>MyCustomFont1.ttf</string\>
        <string\>MyCustomFont2.ttf</string\>
        <string\>MyCustomFont3.ttf</string\>
    </array\>
4. Customize any of the Service Chat SDK font values using [SCAppearanceConfiguration](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCAppearanceConfiguration.html).
    
    To customize the fonts, create an [SCAppearanceConfiguration](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCAppearanceConfiguration.html) instance, set the font descriptor for each font setting you want to change, and store the SCAppearanceConfiguration instance in the [appearanceConfiguration](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCServiceCloud.html#/c:objc\(cs\)SCServiceCloud\(py\)appearanceConfiguration) property of the [ServiceCloud](https://forcedotcom.github.io/ServiceSDK-iOS/releases/api/234.1/Classes/SCServiceCloud.html) shared instance.
    
    Swift Example:
    
    // Create appearance configuration instance
    let config = SCAppearanceConfiguration()
            
    // Customize font
    let descriptor = UIFontDescriptor(fontAttributes: 
        \[UIFontDescriptor.AttributeName.family : "Proxima Nova"\])
    config.setFontDescriptor(descriptor, 
                             fontFileName: "ProximaNova-Light.otf", 
                             forWeight: SCFontWeightLight)
            
    // Add other customizations here...
            
    // Save configuration instance
    ServiceCloud.shared().appearanceConfiguration = config
    
    Objective-C Example:
    
    // Create appearance configuration instance
    SCAppearanceConfiguration \*config = 
        \[SCAppearanceConfiguration new\];
    
    // Customize font
    UIFontDescriptor \*descriptor = 
        \[UIFontDescriptor fontDescriptorWithFontAttributes:@{   
         UIFontDescriptorFamilyAttribute: @"Proxima Nova",
           UIFontDescriptorFaceAttribute: @"Light" }\];
    \[config setFontDescriptor:descriptor
                           fontFileName:@"ProximaNova-Light.otf"
                              forWeight:SCFontWeightLight\];
    
    // Add other customizations here...
    
    // Save configuration instance
    \[SCServiceCloud sharedInstance\].appearanceConfiguration = config;
    
    Be sure to use the exact font descriptor attribute name and font file name for your custom font.