--- schema_version: "1" id: 75aff828ed8645affd4e43baeff846bffe15c4528f7c6aaf56a6e0b484164d0e title: Previous Version of Contacts collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mc_mp_previous_version_of_contacts.md canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mc_mp_previous_version_of_contacts.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: bd787b02205a7c772a7d71b314c49bd10e58ccd83a6a88638b4b0eeb7719b854 description: Complete instructions for using the previous version of Contacts in MobilePush. products: - Marketing - Marketing Cloud Engagement release: "264" --- # Previous Version of Contacts Complete instructions for using the previous version of Contacts in MobilePush. Contacts stores information on subscribers for use in your MobilePush activities. MobilePush gathers information about Contacts via opt-in confirmation and other information submitted via mobile applications. You can’t manually add Contacts or subscriptions to MobilePush. You can use Contacts to manage the following standard information fields about your subscribers: - First Name - Last Name - City - State - ZIP Code - Time Zone - UTC Offset (the number of hours from which the user's time zone deviates from UTC) - Observe DST (whether the user's time zone observers Daylight Savings Time or not) - Platform - System Token - Device ID - Status - Indicates that Contact information can be used as part of a send - **Active** - **Disabled** A Contact displays an **Active** status after opting in to receive notifications via MobilePush. That status changes to **Disabled** when you manually unsubscribe a Contact or when that Contact opts out from further push notifications. Once a Contact status changes to **Disabled**, the Contact must opt back in to receiving push notifications via the app. You can also add attributes for your Contacts to include custom information you require to send messages. Each category of information includes its own entries for preferred name, address, and other information about the subscriber. This information can be used within that category but doesn’t necessarily apply to the subscriber when using other categories. For example, a subscriber might want to have their mobile number associated with certain subscriptions and not others. The Contacts feature allows the subscriber to specify how and where they choose to receive certain information. To assign multiple addresses to a single Contact (such as an email address, a mobile number, and a Twitter handle), you must have the [subscriber key](https://help.salesforce.com/s/articleView?id=mktg.mc_es_subscriber_key.htm&language=en_US) feature enabled for your account. Contact your account executive for more information on enabling subscriber key for your account. You can also include tags on each app subscription for a specific Contact. Those tags derive from information submitted via the app, and you can use those tags to filter Contacts into lists that receive more targeted communications. Use the **Contacts** field to perform the following actions: - Manage existing Contacts - Manage the Lists built on your Contacts - Display the number of opt-ins and percentage of growth over a given time span You can also create an audience of Contacts via Audience Builder and conduct sends to those audiences. Refer to the [Audience Builder](https://help.salesforce.com/s/articleView?id=mktg.mc_ab_audience_builder.htm&language=en_US) documentation for more information on creating audiences to receive your sends. Follow these instructions to create and manage Contacts within the MobilePush app. ## How to Create Contact Attributes Follow these steps to create Attributes for the Contacts in your account. 1. In Contacts, click the **Attributes** tab. 2. Click **Create Attribute.** 3. Enter the name of your attribute in the **Label** field. 4. If you selected **Custom**, click the **Format** dropdown menu and select the format of your new attribute: - **Text** - Enter any default value you wish to display in the **Default Value** field. - Choose whether you wish to set a maximum number of characters for this attribute. - Click **No maximum** to allow any value. - Click **Set a maximum**and enter a number in the field to limit this attribute to a specific number of characters. - **Date** - Choose the date to which you want the attribute to default in the **Default** value field. - Click the **Default to current date** checkbox to always default to the date when that attribute is created for that Contact. - **Numeric** - Enter any default value you wish to display in the **Default Value** field. - Choose whether you wish to set a minimum allowable value for this attribute. - Click **No maximum** to allow any value. - Click **Set a minimum** and enter a number in the field to prevent any values below the specified minimum. - Choose whether you wish to set a maximum allowable value for this attribute. - Click **No maximum** to allow any value. - Click **Set a maximum** and enter a number in the field to prevent any values above the specified minimum. 5. Click **Required** if you wish to make this attribute mandatory for all Contacts. 6. Click **Read-Only** if you don’t want this attribute to be modified. 7. If you wish to ensure that the attribute has a minimum number of characters, click **Set a minimum** and enter a number in the field. Otherwise, click **No minimum**. 8. If you wish to ensure that the attribute has a maximum number of characters, click **Set a maximum** and enter a number in the field. Otherwise, click **No maximum**. 9. Click **Create**. Follow these steps to delete an attribute you created: 1. In Contacts, click the **Attributes** tab. 2. Click the attribute you want to delete. 3. Click the trash can icon in the upper-right corner. 4. Click **Delete**. Ensure that the attribute you want to delete doesn’t contain any information you want to use in further communications. You can’t delete any system-defined attributes. ## How to Import Contacts To import a file, you must include values for the following attributes for each Contact: - Platform - The operating system used by the mobile device: - iPhone OS - Android - System Token - The platform-specific identifier (assigned by the platform owner, such as Apple or Google) requested by the device itself - Device ID - The ID string generated by the Journey Builder for Apps SDK and used to identify the mobile device When you import Contacts from your previous push provider, ensure that you include the System Token value (assigned by the platform owner, such as Apple or Google) stored by that push provider in your import. If you import new Contacts before MobilePush generates the new Device ID, include a unique identifier value for each device involved in the import until that value can be generated. Depending on the attributes included in your account, your import may also require other attributes. You can review the required attributes for your account by following these steps: 1. On the Overview screen, click **Manage Contacts**. 2. In the Mobile window, click the **Attributes** tab. 3. Make sure that your import file includes columns for all attributes with a **Yes** value in the **Required** column. Import files must include values for all required attributes or the import will fail. If your account uses a subscriber key, also known as a contact key, you must include and map that field as part of your import process. When you import a mobile number for a Contact, ensure that you include all applicable country and region codes for that number (such as 1 and the area code for a US number or 44 and the area code for a UK number). Follow these steps to import Contacts into your account: 1. In the **Contacts** field, click the arrow next to **Add Contacts**. 2. Select **Import File**. 3. Select the CSV file you want to upload. 4. Certify that all new Contacts on the CSV file opted in to receive your messages by clicking **I agree.** 5. Click **Upload**. 6. Click **Next**. 7. Select the list to which you want to import the new Contacts in the **Target List** window. 8. Click **Next**. 9. Select the app to which to associate the Contacts in the **App** dropdown menu. 10. Click **Next**. 11. Map the attributes in your CSV file to the attributes in your account. You can map the attributes in one of three ways: - Map by Header Row - Map by Ordinal - Map Manually 12. Click **Next**. 13. Review the information for accuracy. 14. Enter your email address in the Email Address field to receive notification when the import process completes. If you don’t enter an email address, you don’t receive notification. 15. Click **Import**. Limit your import CSV file to 20 MB or less. ## How to Manage and Edit Contacts Follow these steps to change the information for current contacts. 1. Click the mobile number of the Contact you wish to edit. 2. Click the field you wish to edit. 3. Type in the new value. 4. Click **Done**. Follow these steps to create an address for that Contact: 1. Click the mobile number of the Contact you wish to edit. 2. Click **Add Address** and select the type of address you wish to add. 3. Fill in the fields for that address. 4. Click **Done**. Click **Active** or **Disable** on an Address to change the status of the Address for that Contact. You can’t send to a Contact using a disabled Address. Follow these steps to add a new subscription to a Contact. 1. Click the mobile number of the Contact you wish to edit. 2. Click the **Subscriptions** tab. 3. Click **Add Subscriptions**. 4. Select the short or long code you wish to use for the subscription in the **Code** dropdown menu. 5. Click the keyword you wish to use for the subscription in the **Keyword** dropdown menu. 6. Click **Save**. 7. The subscription saves with a **Subscribed** status. To change the status for that subscription, click the **Status** dropdown menu and choose either **Subscribed** or **Unsubscribed**. ## How to Create a New Contacts List Follow these steps to create a new Contact list. 1. In Contacts, click the **Lists** tab. 2. Click **Create List**. 3. Enter the name of the list in the **Name** field. 4. Click **Done**. 5. Enter a description of the list in the **List Description** field. 6. Click **Done**. 7. Enter the email address that receives all notifications regarding this list in the **Notification Email** field. 8. Click **Done**. 9. MobilePush includes a filter that includes all active subscribers by default. If you want to, you can remove this filter. Follow these steps to add filters. 1. Click **Add Filter**. You can choose to filter on Address attributes. 2. Choose the attribute to include in the left half of your filter in the first dropdown menu. 3. Choose the operand used in the filter in the second dropdown menu: - is equal to - is not equal to - is greater than - is greater than or equal to - is less than - is less than or equal to - exists in - exists in whole word - does not exist in - begins with - ends with - contains - does not contain 4. Choose the information to use in the right half of your filter in the text field. 5. Click the plus sign and repeat steps 2 through 4 to add filters. 10. Click **Save**. 11. For filtered lists, click **Publish**. You can include the value **today** as a dynamic value for filtered lists. For example, you can use the filter **date equals today + 1** to specify when birthday emails are sent to Contacts. The dynamic value equals the day on which the filtered list applies to the send. Filtered lists must be published to bring in any new contacts or revised information for existing contacts. ## How to Create a New List from Existing Lists Follow these steps to create a List from the Contacts in your account that meet the List criteria. 1. In Contacts, click the **Lists** tab. 2. Click **Create List**. 3. Enter the name of the List in the **List** field. 4. Enter a description of the List in the **List Description** field. 5. Click **Add** in the **Include** window to add rules to bring Contacts into the List. You can use Boolean conditions to define the rules. 6. Click **Add** in the **Exclude** window to add rules that exclude Contacts from the List. You can use Boolean conditions to define the rules. 7. After you’ve included all the rules you wish to use for that List, click **Save**. 8. Click **Publish** to make the List available for use. Once you click **Publish**, you can monitor the status of your List using the **Status** field: - Available - the List is ready for use. - Queued - MobilePush processes the List in the order in which it was submitted. - In Progress - MobilePush is processing the List. - Publish Failed - MobilePush couldn’t publish the List. Try again. ## How to Manage Lists of Your Contacts Follow these steps to manage the Lists in your account. 1. In Contacts, click the **Lists** tab. 2. Click the List you wish to manage. 3. Make changes to the conditions in the List to increase or reduce the number of included Contacts. 4. After you’ve included all the rules you wish to use for that List, click**Save**. 5. Click **Publish** to make the List available for use. Once you click **Publish**, you can monitor the status of your List using the **Status** field: - Available - you can use the List as part of your sends. - Queued - MobilePush processes the List in the order in which it was submitted. - In Progress - MobilePush is processing the List. - Publish Failed- MobilePush couldn’t publish the List. Try again.