{"title":"How to delete deprecated metadata","slug":"how-to-delete-deprecated-metadata","url":"https://support.storeconnect.com/articles/how-to-delete-deprecated-metadata","url_markdown":"https://support.storeconnect.com/articles/how-to-delete-deprecated-metadata.md","subtitle":null,"summary":"Remove deprecated StoreConnect fields and objects from your Salesforce org after a package upgrade by deploying a destructive changes zip file through Workbench.","type":"Developer_Documentation","video_url":"","keywords":"delete deprecated metadata, deprecated fields, deprecated objects, workbench deploy, destructive changes, salesforce metadata, package upgrade, metadata cleanup, remove deprecated, destructive changes zip, workbench migration, storeconnect maintenance","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"In our ongoing efforts to enhance existing features, we occasionally need to remove the use of an object or field from our package. When this occurs, we append a label to the field or object to show as `[Deprecated]` indicating that they are no longer in use.\n\nPeriodically, we remove deprecated metadata from our package. This ensures that any fresh installations of StoreConnect do not include these deprecated objects and fields. However, if you already have the metadata present in your org, it will not be automatically deleted, even when upgrading to the latest version.\n\nOnce you have been upgraded to a StoreConnect package version that no longer has the deleted metadata, you can manually remove it from your org.\n\n## Download the required zip file for v21 \n\n### [For package versions 21 and up](https://res.cloudinary.com/hzkr6fi81/raw/upload/v1781230462/media/delete-metadata-v21.zip)\n\nAPI Version: 63\n\nIf you are on an earlier version than v21, see the alternative zip file below.\n\n## Remove deleted metadata from your org\n\n1.  Navigate to [Workbench](https://workbench.developerforce.com/).\n2.  Select the API version to match the downloaded zip file you are using.\n3.  Click **Login with Salesforce**. You may get logged in automatically, otherwise log in with your Salesforce username and password.\n5.  Once logged in, in the menu bar, hover over **Migration** and click **Deploy**.\n6.  Click **Choose File** and select the zip file you downloaded from below.\n7.  Enable **Rollback On Error**.\n8.  Choose a **Test Level**.\n9.  Click **Next**.\n10. Click **Deploy**.\n11. Wait for tests and deploy to complete with a status of `Success`.\n\n![Workbench Deploy page with Rollback On Error enabled, Test Level selected, and a successful deployment status](https://res.cloudinary.com/hzkr6fi81/image/upload/v1725790500/knowledge/delete-metadata/delete-metadata_d4exg7.png)\n\n**What will be deleted**\n\nFrom the `s_c__Store__c` object:\n\n-   s\\_c\\_\\_Pay\\_By\\_Account\\_Enabled\\_\\_c\n\nFrom the `s_c__Outlet_Stock_Location__c` object:\n\n-   s\\_c\\_\\_Priority\\_\\_c\n\nFrom the `s_c__Pos_Layout__c` object:\n\n-   s\\_c\\_\\_Grid\\_Columns\\_\\_c\n-   s\\_c\\_\\_Grid\\_Rows\\_\\_c\n\nFrom the `s_c__Trait_Category__c` object:\n\n-   s\\_c\\_\\_Display\\_As\\_Filter\\_Top\\_Level\\_\\_c\n\n## Downloadable zip for pre-v21 users\n\n[For package versions 13.3 and up](https://res.cloudinary.com/hzkr6fi81/raw/upload/v1725790500/knowledge/delete-metadata/deletemetadatav13.3_eqfrvc.zip)\n\nAPI Version: 57\n\n**What will be deleted**\n\nFrom the `s_c__Promotion_Credit__c` object:\n\n-   s\\_c\\_\\_Code\\_\\_c\n\nFrom the `s_c__Promotion__c` object:\n\n-   s\\_c\\_\\_Code\\_\\_c\n\nFrom the `s_c__Booking_Attendee__c` object:\n\n-   All fields\n-   The object itself will also be deleted"}