> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Packaging Material Management

> Prepare and submit branding assets like app logos and ringtones for review before packaging and delivering an exclusive DingTalk App.

Before the exclusive App can be packaged and delivered, the customer needs to prepare a series of assets. These assets must pass a review process before the exclusive App packaging can proceed.

***

## Admin Console Navigation

In the left navigation pane, go to **Organization settings > App Customization > App Packaging > Packaging Material Management**.

<Frame>
  <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/b4b2349a-5fdd-487a-bb6a-cd1f5f1e128e.png" alt="Packaging Material Management navigation" />
</Frame>

## Prerequisites

### Package Name Confirmation

The customer needs to confirm and provide the following information:

| Name           | Content to Provide                                                                                                                                                                                                                            | Description                             |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| Package name   | Android: **com.alibaba.android.rimet.xxxxxx**<br />iOS: **dd.work.exclusive4xxxxxx**<br />(xxxxxx must be lowercase letters, typically an abbreviation of the App's Chinese name. Recommended 6+ characters. Example: dd.work.exclusive4test) | Unique identifier for the exclusive App |
| D-U-N-S Number | The **entity name** associated with the Apple Enterprise Developer account                                                                                                                                                                    | Example: Alibaba Cloud Computing Ltd.   |

### Asset Creation and Application

<Frame>
  <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/c396acb4-9165-4d15-b8c4-bbaf83a591ea.png" alt="Asset creation and application" />
</Frame>

<Note>
  **Android Push Key Application:** [《FCM Push Notification Setup Guide》](/oa/fcm-push-notification-setup)
</Note>

**Asset Specifications:**

DingTalk provides default background images. If the organization wishes to customize, they can create and upload their own assets.

| **Clients**       | **Asset Name**                              | **Type & Format**                                                                                                                                   | **Description**                                                                                                                                                                                              |
| ----------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Basic Information | Application LOGO                            | 1024\*1024<br />.png<br />Rectangle                                                                                                                 | Recommended to use the organization's logo. Must be a square image with right-angle corners; the system will automatically apply rounded corners.<br />Alpha channel must be disabled during image creation. |
|                   | New Message Notification Ringtone           | ≤1 MB<br />≤1 s<br />.mp3                                                                                                                           |                                                                                                                                                                                                              |
|                   | Voice Call Ringtone                         | ≤10 MB<br />≤50 s<br />.mp3                                                                                                                         |                                                                                                                                                                                                              |
| iOS               | iOS App LOGO                                | 1024\*1024<br />.png<br />Rectangle                                                                                                                 | A separate square logo for iOS. Designers need to add the corner badge themselves.<br />Alpha channel must be disabled during image creation.                                                                |
|                   |                                             | 140\*140<br />.png<br />Rounded Rectangle                                                                                                           |                                                                                                                                                                                                              |
|                   |                                             | 210\*210<br />.png<br />Rounded Rectangle                                                                                                           |                                                                                                                                                                                                              |
|                   | iOS Login Page LOGO                         | 100\*100<br />.png<br />Circle                                                                                                                      |                                                                                                                                                                                                              |
|                   |                                             | 150\*150<br />.png<br />Circle                                                                                                                      |                                                                                                                                                                                                              |
|                   | iOS Sharing LOGO                            | 128\*128<br />.png<br />White Background, Rounded Rectangle                                                                                         |                                                                                                                                                                                                              |
|                   |                                             | 192\*192<br />.png<br />White Background, Rounded Rectangle                                                                                         |                                                                                                                                                                                                              |
|                   | iOS Sharing LOGO (Active state)             | 128\*128<br />.pngType<br />Rounded Rectangle                                                                                                       |                                                                                                                                                                                                              |
|                   |                                             | 192\*192<br />.pngType<br />Rounded Rectangle                                                                                                       |                                                                                                                                                                                                              |
|                   | iPhone Light Login Background               | 1179\*579<br />.png                                                                                                                                 |                                                                                                                                                                                                              |
|                   | iPhone Dark Login Background                |                                                                                                                                                     |                                                                                                                                                                                                              |
|                   | iPad Light Login Background                 | 1536\*2048<br />.png                                                                                                                                |                                                                                                                                                                                                              |
|                   | iPad Dark Login Background                  |                                                                                                                                                     |                                                                                                                                                                                                              |
|                   | iPad Login Page Right Blank Area            | 400\*400<br />.png                                                                                                                                  | Background must be transparent                                                                                                                                                                               |
|                   |                                             | 600\*600<br />.png                                                                                                                                  |                                                                                                                                                                                                              |
|                   | Splash Page Background                      | 1125\*2436<br />.png<br />Light background                                                                                                          | Create a pure background image only; the app will automatically place the logo in the center. Versions 7.0.45+ support full-screen splash images.                                                            |
|                   | Splash Bottom Background                    | 375\*143<br />.png<br />Transparent, light background                                                                                               | Create a pure background image only; the app will automatically place the logo in the center                                                                                                                 |
|                   |                                             | 750\*286<br />.png<br />Transparent, light background                                                                                               |                                                                                                                                                                                                              |
|                   |                                             | 1125\*429<br />.png<br />Transparent, light background                                                                                              |                                                                                                                                                                                                              |
|                   | Splash Animation (optional)                 | .mp4<br />≤1 MB, ≤2 s                                                                                                                               | Optional. If not uploaded, the splash background image will be displayed.                                                                                                                                    |
| Android           | Desktop Logo                                | 1024\*1024<br />.png<br />Rectangle                                                                                                                 |                                                                                                                                                                                                              |
|                   | Login Logo                                  | 1024\*1024<br />.png<br />Circle                                                                                                                    |                                                                                                                                                                                                              |
|                   | Splash Page LOGO                            | 1024\*1024<br />.png<br />Rounded Rectangle                                                                                                         |                                                                                                                                                                                                              |
|                   | Sharing Logo                                | 1024\*1024<br />.png<br />White Background, Rounded Rectangle                                                                                       |                                                                                                                                                                                                              |
|                   | Notification Bar / Taskbar LOGO             | 1024\*1024<br />.png<br />White Background, Circle, Hollow Transparent LOGO                                                                         |                                                                                                                                                                                                              |
|                   | Light Login Background                      | 1179\*579<br />.png                                                                                                                                 |                                                                                                                                                                                                              |
|                   | Dark Login Background                       |                                                                                                                                                     |                                                                                                                                                                                                              |
|                   | Phone Splash Background                     | 1125\*2436<br />.png<br />Light Background                                                                                                          | Create a pure background image only; the app will automatically place the logo in the center. Versions 7.0.45+ support full-screen splash images.                                                            |
|                   | Tablet Landscape Splash Background          | 2560\*1600<br />.png<br />Light Background                                                                                                          | Versions 7.0.45+ support full-screen splash images                                                                                                                                                           |
|                   | Splash Bottom Background                    | 1024\*180<br />.png<br />Transparent, Light Background                                                                                              |                                                                                                                                                                                                              |
|                   | Splash Animation (optional)                 | .mp4<br />≤1 MB, ≤2 s                                                                                                                               | Optional. If not uploaded, the splash background image will be displayed.                                                                                                                                    |
| Windows           | Windows Status Bar Prefix                   | 62\*16<br />.png<br />Width: 62–100                                                                                                                 |                                                                                                                                                                                                              |
|                   |                                             | 124\*32<br />.png<br />Width: 124–200                                                                                                               |                                                                                                                                                                                                              |
|                   | Windows Desktop LOGO                        | Square rounded or circular<br />.ico<br />Includes the following 8 sizes: 16\*16、24\*24、<br />32\*32、64\*64、96\*96、128\*128、192\*192、<br />256\*256 | Recommended to use Axialis IconWorkshop. Tutorial: [https://www.axialis.com/tutorials/tutorial-iw023.html](https://www.axialis.com/tutorials/tutorial-iw023.html)                                            |
|                   | Windows Tray LOGO                           | Recommended: circular<br />.ico<br />Includes the following 4 sizes: 16\*16、24\*24、<br />32\*32、64\*64                                              |                                                                                                                                                                                                              |
|                   | Windows Tray Red Dot LOGO                   |                                                                                                                                                     |                                                                                                                                                                                                              |
|                   | Windows Login Page LOGO                     | 192\*192<br />.png<br />Circle                                                                                                                      |                                                                                                                                                                                                              |
|                   |                                             | 96\*96<br />.png<br />Circle                                                                                                                        |                                                                                                                                                                                                              |
|                   |                                             | 48\*48<br />.png<br />Circle                                                                                                                        |                                                                                                                                                                                                              |
|                   | Windows "Upgrade" Modal Logo                | 304\*152<br />.png                                                                                                                                  |                                                                                                                                                                                                              |
|                   | Windows "About" Page Background             | 840\*600<br />.png                                                                                                                                  |                                                                                                                                                                                                              |
|                   | No Message Background                       | 320\*320<br />.png                                                                                                                                  |                                                                                                                                                                                                              |
| Mac               | Application LOGO                            | Square rounded or circular<br />.png<br />Includes the following 7 sizes:<br />16\*16、32\*32、64\*64、128\*128、256\*256、512\*512、1024\*1024           |                                                                                                                                                                                                              |
|                   | Login Logo                                  | 100\*100<br />.png<br />Circle                                                                                                                      |                                                                                                                                                                                                              |
|                   |                                             | 200\*200<br />.png<br />Circle                                                                                                                      |                                                                                                                                                                                                              |
|                   | Mac Status Bar                              | 16\*16<br />.png                                                                                                                                    | Recommended: black background, center LOGO hollow transparent                                                                                                                                                |
|                   |                                             | 32\*32<br />.png                                                                                                                                    |                                                                                                                                                                                                              |
|                   | Mac "About" Page Background                 | 840\*658<br />.png                                                                                                                                  |                                                                                                                                                                                                              |
|                   | Mac "Download Exclusive Package" Background | 620\*266<br />.png                                                                                                                                  |                                                                                                                                                                                                              |
|                   |                                             | 1240\*532<br />.png                                                                                                                                 |                                                                                                                                                                                                              |
|                   | No Message Background                       | 320\*320<br />.png                                                                                                                                  |                                                                                                                                                                                                              |

## Asset Upload

### Basic Information Upload

<Steps>
  <Step title="Asset upload">
    * Click to upload the app logo asset.
    * After successful upload, select the badge type and preview the effect below. **Note:** To use the "no badge" option, contact your DingTalk representative to apply separately — otherwise it will not be approved.
    * After selecting the badge type, click **Apply to All Clients** to apply the logo across all client platforms.
    * Linux-based platforms currently require a separate upload and cannot use the apply-to-all feature.

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/6953daba-80c3-431c-a98d-7a3f5452fb92.png" alt="Upload app logo asset" style={{width: '32%', minWidth: '180px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl65AykARd2Oke/img/e4da21e0-c4a9-4259-9ec5-9867edcb11cc.png" alt="Select badge type" style={{width: '32%', minWidth: '180px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl65AykARd2Oke/img/f2ac3934-19b7-47b1-8bea-ca3dc30d1ff4.png" alt="Apply to all clients" style={{width: '32%', minWidth: '180px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>
  </Step>

  <Step title="App name">
    Enter the app name according to the naming conventions:

    In principle, the app shall be named by the customer at its own discretion, subject to the following requirements:

    * The app name must not include any third-party brand (especially those of competitors), and may not mix Chinese characters with English words or characters. If the app name incorporates the customer's own brand, trade name, or corporate name, the customer must provide proof of trademark rights.
    * The intellectual property rights to the app name and icon may be owned by the customer. The customer shall apply for trademark registration to protect such rights at its own expense.

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/90675733-1656-4b00-881b-cc48ad0f7cb3.png" alt="App name configuration" />
    </Frame>
  </Step>

  <Step title="Ringtone customization">
    * New message alert and voice call ringtones support enterprise customization — audio assets can be uploaded directly.
    * New message alert: upload an .mp3 file ≤1 MB and ≤1 second.
    * Voice call ringtone: upload an .mp3 file ≤10 MB and ≤50 seconds.

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/2e1ccb7c-8fc6-428e-baf8-6e30fe5799c5.png" alt="Ringtone customization" />
    </Frame>
  </Step>
</Steps>

### Android

* Google FCM Push:

[《FCM Push Notification Setup Guide》](/oa/fcm-push-notification-setup)

<Frame>
  <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/3a5ab23c-f0e1-4feb-af1f-169397358df0.png" alt="Android FCM push configuration" />
</Frame>

### iOS

* All iOS assets are required, except for the splash animation (optional).
* iOS requires a separate upload of the square logo. See the asset specifications above for format requirements.
* For in-house packaging, the customer needs to upload the packaging certificate and password (optional). For ABM/UAD packaging, contact customer service for assistance.
* After ensuring all assets are filled in, click **Save** first, then **Submit for Review**.

<div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
  <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AJdl65AykARd2Oke/img/a135504b-d24c-401a-9be0-8bb6e41e1a58.png" alt="iOS asset upload" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

  <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/0f424aca-89a8-460a-a729-6638e2fa9f42.png" alt="iOS submit for review" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
</div>

### Windows / Mac

As above, after the customer fills in the image assets for Windows and Mac per the requirements, click **Save** first, then **Submit for Review**.

## Asset Review

* Basic information and assets for all five client platforms are submitted for review separately. Before submitting, click **Save** first.
* After submission, both the basic information and the corresponding client information must pass review before proceeding to the next step of App creation.
* If a review fails, hover over the failure message to view the reason.

<Frame>
  <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/mxPOG5z1rZDENnKa/img/49ceaebc-2bed-45c7-a4cc-5d884b198d69.png" alt="Asset review" />
</Frame>

## Q\&A

| **Prerequisites**      | None                                                                                                                                                                                                                                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Supported Scope**    | No version dependency                                                                                                                                                                                                                                                                             |
| **Enforcement Method** | Desktop: After setup is complete, employees whose primary organization is this enterprise can use the app after it is rebuilt and reinstalled.<br />Mobile: After setup is complete, employees whose primary organization is this enterprise can use the app after it is rebuilt and reinstalled. |