{"title":"Subscription Change Object Reference","slug":"subscription-change-object-reference","url":"https://support.storeconnect.com/articles/subscription-change-object-reference","url_markdown":"https://support.storeconnect.com/articles/subscription-change-object-reference.md","subtitle":null,"summary":"Records each subscription plan change (upgrade or downgrade) for audit trail and reporting. Tracks old/new product, pricing, proration, and the mode used.","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Subscription Change, s_c__Subscription_Change__c, api","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\nRecords each subscription plan change (upgrade or downgrade) for audit trail and reporting. Tracks old/new product, pricing, proration, and the mode used.\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Subscription_Change__c` |\n| **Label** | Subscription Change |\n| **Plural Label** | Subscription Changes |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Changed At | `s_c__Changed_At__c` | DateTime | No | When the customer initiated the plan change. For upgrades this equals Effective_Date. For downgrades this is when they requested it, while Effective_Date is when it takes effect (next renewal). |\n| Direction | `s_c__Direction__c` | Picklist | No | Whether this was an initial signup, upgrade, or downgrade. |\n| Effective Date | `s_c__Effective_Date__c` | DateTime | No | When the plan change took effect. |\n| New Price | `s_c__New_Price__c` | Currency(18,2) | No | The period price after the plan change. |\n| New Product | `s_c__New_Product_Id__c` | Lookup ([Product2](product2-object-reference)) | No | The product after the plan change. |\n| Old Price | `s_c__Old_Price__c` | Currency(18,2) | No | The period price before the plan change. |\n| Old Product | `s_c__Old_Product_Id__c` | Lookup ([Product2](product2-object-reference)) | No | The product before the plan change. |\n| Order | `s_c__Order_Id__c` | Lookup ([Order](order-object-reference)) | No | The pro-rata charge order (upgrades) or audit order (downgrades). |\n| Plan Change Mode | `s_c__Plan_Change_Mode__c` | Picklist | No | The proration mode used: prorate_immediately, prorate_on_renewal, or no_proration. |\n| Proration Amount | `s_c__Proration_Amount__c` | Currency(18,2) | No | The prorated amount charged for this plan change. 0 for downgrades or no_proration mode. |\n| Subscription | `s_c__Subscription_Id__c` | Lookup ([s_c__Subscription__c](subscription-object-reference)) | No | The subscription that was changed. |\n| StoreConnect External ID | `s_c__sC_Id__c` | Text(36) | No | StoreConnect External ID, do not modify in Salesforce |\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__New_Product_Id__c` | Lookup | [Product2](product2-object-reference) | Subscription_Changes_New_Product |\n| `s_c__Old_Product_Id__c` | Lookup | [Product2](product2-object-reference) | Subscription_Changes_Old_Product |\n| `s_c__Order_Id__c` | Lookup | [Order](order-object-reference) | Subscription_Changes_Order |\n| `s_c__Subscription_Id__c` | Lookup | [s_c__Subscription__c](subscription-object-reference) | Subscription_Changes_Subscription |"}