--- schema_version: "1" id: d6cc262273d12d0d45b213cd7bf0e3d05acb6870ca8e64dea9506af0f0606b7d title: WorkGoal collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_workgoal.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_workgoal.htm source_site: developer.salesforce.com content_type: documentation content_hash: 957a768367758945d93f6a6277fe6e6cb7a70edc31374305dafd6c195fdcf7f5 description: Represents the components of a goal, such as its description and associated metrics. This object has been deprecated as of API version 35.0. Use the Goal object to query information about WDC goals. --- # WorkGoal Represents the components of a goal, such as its description and associated metrics. This object has been deprecated as of API version 35.0. Use the [Goal](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_goal.htm#sforce_api_objects_Goal "The Goal object represents the components of a goal such as its name, description, and status.") object to query information about WDC goals. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note The original WDC feature is unavailable as of Spring '22. This object isn't available as of API version 54.0. For more information, see [Phased WDC (legacy Work.com) Feature Retirement](https://help.salesforce.com/s/articleView?id=000356306&type=1&language=en_US). ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Related [WorkGoalCollaborator](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_workgoalcollaborator.htm "Represents collaborators on a WorkGoal object. This doesn’t include WorkGoal followers, which is handled by Chatter Feed Follow functionality. This object has been deprecated as of API version 35.0. Use the Goal object to query information about WDC goals."), [WorkGoalLink](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_workgoallink.htm "Represents the relationship between two goals (many to many relationship). This object has been deprecated as of API version 35.0. Use the GoalLink object to query information about the relationship between two WDC goals."), [WorkGoalFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_customobject__feed.htm "Represents the feed, specifically posts and feed-tracked changes, on a custom object.") ## Fields | Field Name | Details | | --- | --- | | ActualValue | Type double Properties Create, Filter, Nillable, Sort, Update Description The actual value of the WorkGoal metric. Applicable only to WorkGoal objects of Type: Metric. | | ActualValueExternalUrl | Type url Properties Create, Filter, Group, Nillable, Sort, Update Description Contains a URL that references WDC data synchronization for the actual value of a metric. Applicable only to WorkGoal objects of Type: Metric. | | CompletionDate | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The completion date of the goal. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note Field-level security limits access to only administrators and owners by default, and only they can complete a goal. | | Description | Type textarea (max length 4000) Properties Create, Nillable, Update Description The description of the goal. | | DueDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The date the WorkGoal object is due (optional). Applicable only to WorkGoal objects of Type: Metric. | | FlaggedAs | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The progress of the WorkGoal object. Applicable only to WorkGoal objects of Type: Metric. Possible values: - On Track: Progress on the metric is on track. - Behind: Progress on the metric is behind schedule. - Postponed: The metric is postponed. - Critical: Progress on the metric is critical. | | ImageUrl | Type url Properties Create, Filter, Group, Nillable, Sort, Update Description The URL for the goal image. The image must be stored in Documents and set as externally available. Applicable only to WorkGoal objects of Type: Goal. | | InitialValue | Type double Properties Create, Filter, Nillable, Sort, Update Description The initial value of the WorkGoal metric. Applicable only to WorkGoal objects of Type: Metric and MetricType: Progress or Percent. | | IsKeyCompanyGoal | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Used to indicate if the goal is a key company goal. Used for the Company Goal Showcase. Applicable only to WorkGoal objects of Type: Goal. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The time stamp that indicates when the current user last viewed a record that is related to this goal. | | LastSyncDate | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The time stamp that indicates when the actual value was last synced with the associated metrics report. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The time stamp that indicates when the current user last viewed this goal. | | MetricType | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of metric that is represented. (See values in the following list). Applies only to WorkGoal objects of Type: Metric. Possible values: - Progress: ActualValue / TargetValue as a percentage - Percent: the metric as a percentage only - YesNo: the completed / not completed metric as a milestone - Absolute: Deprecated | | MetricTypeDataSource | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Specifies how the metric (ActualValue and CurrentValue) is updated. Applies only to WorkGoal objects of Type: Goal and Metric. Possible values: - Manual: indicates that the actual and target value of the metric is updated manually by the user - Rollup: indicates that the actual and target value of a goal is rolled up automatically by WDC Goals - DataSyncActualOnly: indicates that the actual value of the metric is linked to a Salesforce report | | Name | Type string Properties Create, Filter, Group, idLookup, Sort, Update Description The name of the WorkGoal object. (Maximum length is 255.) | | OverallStatus | Type string Properties Filter, Group, Nillable, Sort Description The overall calculated status of the WorkGoal based on FlaggedAs and CompletionDate. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description ID of the user who owns the WorkGoal. | | ParentId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies the structural parent of the WorkGoal. For example, a goal that has a metric is represented by a WorkGoal of Type Metric, which has a parent of WorkGoal of Type Goal. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note The root and the parent must be set to the parent goal for any child metrics. | | Progress | Type percent Properties Filter, Nillable, Sort Description Read Only. The overall progress of the WorkGoal. | | RootId | Type reference to a WorkGoal object Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies the structural root of the WorkGoal. For example, a goal that has a metric is represented by a WorkGoal of Type Metric, which has a root of WorkGoal of Type Goal. | | State | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description The state of the WorkGoal object. Applies only to WorkGoal objects of Type: Metric. Possible values: - Draft: the draft state for the WorkGoal - Published: published state for the WorkGoal - Archived: archived state for the WorkGoal (for example, goals that no longer apply) | | TargetValue | Type double Properties Create, Filter, Nillable, Sort, Update Description The target value of the WorkGoal. Applies only to WorkGoal objects of Type: Metric. | | Type | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description The type of the WorkGoal object, used to differentiate between the components of a goal. (This field is used to represent components of a goal such as its description and associated metrics.) Possible values: - Goal: a goal - Metric: a metric (typically associated with goals) - Objective: an objective - KeyResult: a key result (typically associated with objectives - V2Mom: a V2MOM (pilot feature) - Vision: a vision (pilot feature — typically associated with V2MOM) - Value: a value (pilot feature - typically associated with V2MOM) - Method: a method (pilot feature - typically associated with V2MOM) - Obstacle: an obstacle (pilot feature - typically associated with V2MOM) - Measure: a measure (pilot feature - typically associated with a method) ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note Administrators can rename goals and metrics to objectives and key results, respectively. If this preference is enabled, use the Type Objective or KeyResult. Otherwise, use the default Type Goal or KeyResult. | | Weight | Type double Properties Create, Filter, Nillable, Sort, Update Description The weight of the goal or metric. The sum of the weights should equal 100%. | ## Associated Objects This object has the following associated objects. Unless noted, they are available in the same API version as this object. [WorkGoalFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") (API verison 35.0) Feed tracking is available for the object. [WorkGoalHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. The original WDC feature is unavailable as of Spring '22. This object isn't available as of API version 54.0. For more information, see [Phased WDC (legacy Work.com) Feature Retirement](https://help.salesforce.com/s/articleView?id=000356306&type=1&language=en_US). [WorkGoalOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. The original WDC feature is unavailable as of Spring '22. This object isn't available as of API version 54.0. For more information, see [Phased WDC (legacy Work.com) Feature Retirement](https://help.salesforce.com/s/articleView?id=000356306&type=1&language=en_US). [WorkGoalShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.