--- schema_version: "1" id: d75003ec13fb41b1763e6b7f3f608f7b2baced44ce599897beca5d6a8aeb08b4 title: KnowledgeSettings collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_knowledgesettings.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_knowledgesettings.htm source_site: developer.salesforce.com content_type: documentation content_hash: eb4556bc314c52ef5dd165f1216e170d680f47b39c0da421af377720e1b2bba5 description: Represents the metadata used to manage settings for Salesforce Knowledge. --- # KnowledgeSettings Represents the metadata used to manage settings for Salesforce Knowledge. This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") metadata type and inherits its fullName field. In the package manifest, all organization settings metadata types are accessed using the Settings name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type.") for more details. ## File Suffix and Directory Location KnowledgeSettings values are stored in a single file named Knowledge.settings in the settings directory. The .settings files are different from other named components because there’s only one settings file for each settings component. ## Version KnowledgeSettings is available in API version 27.0 and later. ## Fields | Field Name | Field Type | Description | | --- | --- | --- | | answers | [KnowledgeAnswerSettings](#KnowledgeAnswerSettings) | Represents the metadata used to manage settings for Salesforce Knowledge and Answers. | | cases | [KnowledgeCaseSettings](#KnowledgeCaseSettings) | Represents the metadata used to manage settings for Salesforce Knowledge and Cases. | | defaultLanguage | string | Required. The default language for Salesforce Knowledge. Use the abbreviation for the language, for example, en\_US for United States English. | | enableChatterQuestionKBDeflection | boolean | Indicates whether tracking for case deflection via Chatter is enabled (true) or not (false). | | enableCreateEditOnArticlesTab | boolean | Indicates whether users can create and edit articles on the articles tab (true) or not (false). | | enableExternalMediaContent | boolean | Indicates whether connecting to external media is enabled (true) or not (false). | | enableKbStandardSharing | boolean | Indicates whether standard Salesforce sharing is enabled (true) or not (false). | | enableKnowledge | boolean | Indicates whether Salesforce Knowledge is enabled (true) or not (false). This field is false by default. | | enableKnowledgeAgentContribution | boolean | Indicates whether a user can create an article from a case (true) or not (false). (Classic only) | | enableKnowledgeArticleTextHighlights | boolean | Indicates whether text snippet highlights in Salesforce Knowledge search results are enabled (true) or not (false). This field is true by default. Available in API version 47.0 and later. | | enableKnowledgeAnswersPromotion | boolean | Indicates whether a user can create an article from a reply (true) or not (false). (Classic Only) | | enableKnowledgeCaseRL | boolean | Indicates whether creating a list of cases linked to an article is enabled (true) or not (false). (Classic Only) | | enableKnowledgeKeywordAutoComplete | boolean | Indicates whether auto-complete for keywords is enabled (true) or not (false) when searching Salesforce Knowledge. This field is true by default. Available in API version 47.0 and later. | | enableKnowledgeTitleAutoComplete | boolean | Indicates whether auto-complete for article titles is enabled (true) or not (false) when searching Salesforce Knowledge. This field is true by default. Available in API version 47.0 and later. | | enableLightningKbAutoLoadRichTextField | boolean | Indicates whether rich text fields are enabled for editing when an article loads in Lightning Knowledge (true) or not (false). This field is false by default. Available in API version 47.0 and later. | | enableLightningKnowledge | boolean | Indicates whether Lightning Knowledge is enabled (true) or not (false). | | languages | [KnowledgeLanguageSettings](#KnowledgeLanguageSettings) | A list of languages enabled for Salesforce Knowledge. | | showArticleSummariesCustomerPortal | boolean | Indicates whether article summaries appear in the Customer Portal (true) or not (false). | | showArticleSummariesInternalApp | boolean | Indicates whether article summaries appear in the internal knowledge base (true) or not (false). | | showArticleSummariesPartnerPortal | boolean | Indicates whether article summaries appear in the partner portal (true) or not (false). | | showValidationStatusField | boolean | Indicates whether validation status appears on articles (true) or not (false). | | suggestedArticles | [KnowledgeSuggestedArticlesSettings](#KnowledgeSuggestedArticlesSettings) | Represents the metadata used to manage settings for the case fields used to suggest articles for cases. Available in API version 37.0 and later. | | votingEnabled | boolean | When true, enables users to vote for a product or feature that uses Vote, such as Articles in Knowledge. Available in API version 50.0 and later. | ## KnowledgeAnswerSettings Represents the metadata used to manage settings for Salesforce Knowledge and Answers. | Field Name | Field Type | Description | | --- | --- | --- | | assignTo | string | Specifies the username an article is assigned to from Answers. | | defaultArticleType | string | The default article type for articles created from Answers. Uses the API name of the article type. | | enableArticleCreation | boolean | Indicates whether users can create articles from Answers (true) or not (false). | ## KnowledgeCaseSettings Represents the metadata used to manage settings for Salesforce Knowledge and Cases.
Field Name Field Type Description
articlePDFCreationProfile string The profile used to create a PDF of an article from Cases.
articlePublicSharingSites KnowledgeSitesSettings Represents the metadata used to manage settings for Salesforce Knowledge and Sites.
articlePublicSharingCommunities KnowledgeSitesSettings Represents the metadata used to manage settings for Salesforce Knowledge and Experience Cloud sites.
articlePublicSharingSitesChatterAnswers KnowledgeSitesSettings Represents the metadata used to manage settings for Salesforce Knowledge and Sites with Chatter Answers.
assignTo string Specifies the username an article is assigned to from Cases.
customizationClass string Specifies the Apex class used for customization.
defaultContributionArticleType string The default article type for articles created from Cases.
editor KnowledgeCaseEditor (enumeration of type string) Indicates the rich text editor type. Valid values are:
  • simple
  • standard
enableArticleCreation boolean Indicates whether users can create articles from Cases (true) or not (false). Controls whether other fields on KnowledgeCaseSettings can be set.
enableArticlePublicSharingSites boolean Indicates whether articles can be shared via a public site (URL) from Cases (true) or not (false).
enableCaseDataCategoryMapping boolean Indicates whether Case Data Category mapping is enabled (true) or not (false).
useProfileForPDFCreation boolean Indicates whether a profile is used to create a PDF of an article from Cases (true) or not (false).
## KnowledgeSitesSettings Represents the metadata used to manage settings for Salesforce Knowledge and Sites. | Field Name | Field Type | Description | | --- | --- | --- | | site | string\[\] | Specifies the site used for Salesforce Knowledge and Sites. | ## KnowledgeLanguageSettings A list of languages enabled for Salesforce Knowledge. KnowledgeLanguageSettings is available in API version 28.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | language | [KnowledgeLanguage](#KnowledgeLanguage)\[\] | Represents the metadata used to manage settings for the languages enabled for Salesforce Knowledge. | ## KnowledgeLanguage Represents the metadata used to manage settings for the languages enabled for Salesforce Knowledge. KnowledgeLanguage is available in API version 28.0 and later.
Field Name Field Type Description
active boolean Indicates whether the language is enabled (true) or not (false).
defaultAssignee string The default assignee for articles in the language.
defaultAssigneeType KnowledgeLanguageLookupValueType (enumeration of type string) Indicates the default assignee type. Valid values are:
  • User
  • Queue
defaultReviewer string The default reviewer for articles in the language.
defaultReviewerType KnowledgeLanguageLookupValueType (enumeration of type string) Indicates the default reviewer type. Valid values are:
  • User
  • Queue
name string The code for the language name, for example: English is en. See “What languages does Salesforce support?” in the Salesforce Help for a list of supported languages and their codes.
## KnowledgeSuggestedArticlesSettings Represents the metadata used to manage settings for the articles suggested for cases, work orders, and work order line items. The Work Order and Work Order Line Item objects must be enabled in the org to use the associated fields. | Field Name | Field Type | Description | | --- | --- | --- | | caseFields | [KnowledgeCaseFieldsSettings](#KnowledgeCaseFieldSettings) | Represents a list of the case fields used to suggest articles for the case. | | useSuggestedArticlesForCase | boolean | Indicates whether case content is used to suggest articles for cases (true) or not (false). | | workOrderFields | [KnowledgeWorkOrderFieldsSettings](#KnowledgeWorkOrderFieldSettings) | Represents a list of the work order fields used to suggest articles for the work order. | | workOrderLineItemFields | [KnowledgeWorkOrderLineItemFieldsSettings](#KnowledgeWorkOrderLineItemFieldSettings) | Represents a list of the work order line item fields used to suggest articles for the work order line item. | ## KnowledgeCaseFieldsSettings Represents a list of the case fields used to suggest articles for the case. Available in API version 37.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | field | [KnowledgeCaseField](#KnowledgeCaseField)\[\] | Specifies the names of the case fields used to suggest articles for the case. | ## KnowledgeCaseField Represents the name of the case field used to suggest articles for the case. Available in API version 37.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | name | string | Specifies the name of the case field used to suggest articles for the case. | ## KnowledgeWorkOrderFieldsSettings Represents a list of the work order fields used to suggest articles for the work order. Available in API version 39.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | field | [KnowledgeWorkOrderField](#KnowledgeWorkOrderField)\[\] | Specifies the names of the work order fields used to suggest articles for the work order. | ## KnowledgeWorkOrderField Represents the name of the work order field used to suggest articles for the work order. Available in API version 39.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | name | string | Specifies the name of the work order field used to suggest articles for the work order. | ## KnowledgeWorkOrderLineItemFieldsSettings Represents a list of the work order line item fields used to suggest articles for the work order line item. Available in API version 39.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | field | [KnowledgeWorkOrderLineItemField](#KnowledgeWOLIField)\[\] | Specifies the names of the work order line item fields used to suggest articles for the work order line item. | ## KnowledgeWorkOrderLineItemField Represents the name of the work order line item field used to suggest articles for the work order line item. Available in API version 39.0 and later. | Field Name | Field Type | Description | | --- | --- | --- | | name | string | Specifies the name of the work order line item field used to suggest articles for the work order line item. | ## Declarative Metadata Sample Definition This is a sample Knowledge settings file. false partner portal knowledge profile KnowledgeSite PKB2Site ChatterAnswersSite ChatterAnswersSite testall@kb.org Support simple true true true ja true true true true true true true Subject SuppliedEmail true ## Wildcard Support in the Manifest File The wildcard character \* (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type."). For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/file_based_zip_file.htm "The deploy() and retrieve() calls are used to deploy and retrieve a .zip file. Within the .zip file is a project manifest (package.xml) that lists what to retrieve or deploy, and one or more XML components that are organized into folders.").