KnowledgeSettings

Represents the metadata used to manage settings for Salesforce Knowledge.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See Settings for more details.

This type extends Metadata and inherits its fields.

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.

Introduced in API version 27.0.

• Type: KnowledgeAnswerSettings
• Required: No
• Description: Represents the metadata used to manage settings for Salesforce Knowledge and Answers.

• Type: KnowledgeCaseSettings
• Required: No
• Description: Represents the metadata used to manage settings for Salesforce Knowledge and Cases.

• Type: string
• Required: No
• Description: Required. The default language for Salesforce Knowledge. Use the abbreviation for the language, for example, en_US for United States English.

• Type: boolean
• Required: No
• Description: Indicates whether tracking for case deflection via Chatter is enabled (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether users can create and edit articles on the articles tab (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether connecting to external media is enabled (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether standard Salesforce sharing is enabled (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether Salesforce Knowledge is enabled (true) or not (false). This field is false by default.

• Type: boolean
• Required: No
• Description: Indicates whether a user can create an article from a case (true) or not (false). (Classic only)

• Type: boolean
• Required: No
• Description: Indicates whether a user can create an article from a reply (true) or not (false). (Classic Only)

• Type: boolean
• Required: No
• Introduced: API version 47.0
• Description: Indicates whether text snippet highlights in Salesforce Knowledge search results are enabled (true) or not (false). This field is true by default.

• Type: boolean
• Required: No
• Description: Indicates whether creating a list of cases linked to an article is enabled (true) or not (false). (Classic Only)

• Type: boolean
• Required: No
• Introduced: API version 47.0
• Description: Indicates whether auto-complete for keywords is enabled (true) or not (false) when searching Salesforce Knowledge. This field is true by default.

• Type: boolean
• Required: No
• Introduced: API version 47.0
• Description: Indicates whether auto-complete for article titles is enabled (true) or not (false) when searching Salesforce Knowledge. This field is true by default.

• Type: boolean
• Required: No
• Introduced: API version 47.0
• Description: 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.

• Type: boolean
• Required: No
• Description: Indicates whether Lightning Knowledge is enabled (true) or not (false).

• Type: boolean
• Required: No

• Type: KnowledgeLanguageSettings
• Required: No
• Description: A list of languages enabled for Salesforce Knowledge.

• Type: boolean
• Required: No
• Description: Indicates whether article summaries appear in the Customer Portal (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether article summaries appear in the internal knowledge base (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether article summaries appear in the partner portal (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether validation status appears on articles (true) or not (false).

• Type: KnowledgeSuggestedArticlesSettings
• Required: No
• Introduced: API version 37.0
• Description: Represents the metadata used to manage settings for the case fields used to suggest articles for cases.

• Type: boolean
• Required: No

• Type: boolean
• Required: No
• Introduced: API version 50.0
• Description: When true, enables users to vote for a product or feature that uses Vote, such as Articles in Knowledge.

Represents the metadata used to manage settings for Salesforce Knowledge and Answers.

• Type: string
• Required: No
• Description: Specifies the username an article is assigned to from Answers.

• Type: string
• Required: No
• Description: The default article type for articles created from Answers. Uses the API name of the article type.

• Type: boolean
• Required: No
• Description: Indicates whether users can create articles from Answers (true) or not (false).

Represents the name of the case field used to suggest articles for the case.

Introduced in API version 37.0.

• Type: string
• Required: No
• Description: Specifies the name of the case field used to suggest articles for the case.

Represents a list of the case fields used to suggest articles for the case.

Introduced in API version 37.0.

• Type: KnowledgeCaseField[]
• Required: No
• Description: Specifies the names of the case fields used to suggest articles for the case.

Represents the metadata used to manage settings for Salesforce Knowledge and Cases.

• Type: string
• Required: No
• Description: The profile used to create a PDF of an article from Cases.

• Type: KnowledgeCommunitiesSettings
• Required: No
• Description: Represents the metadata used to manage settings for Salesforce Knowledge and Experience Cloud sites.

• Type: KnowledgeSitesSettings
• Required: No
• Description: Represents the metadata used to manage settings for Salesforce Knowledge and Sites.

• Type: KnowledgeSitesSettings
• Required: No
• Description: Represents the metadata used to manage settings for Salesforce Knowledge and Sites with Chatter Answers.

• Type: string
• Required: No
• Description: Specifies the username an article is assigned to from Cases.

• Type: string
• Required: No
• Description: Specifies the Apex class used for customization.

• Type: string
• Required: No
• Description: The default article type for articles created from Cases.

• Type: KnowledgeCaseEditor (enumeration of type string)
• Required: No
• Description: Indicates the rich text editor type.
• Possible values:
  • simple
  • standard

• Type: boolean
• Required: No
• Description: Indicates whether users can create articles from Cases (true) or not (false). Controls whether other fields on KnowledgeCaseSettings can be set.

• Type: boolean
• Required: No
• Description: Indicates whether articles can be shared via a public site (URL) from Cases (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether Case Data Category mapping is enabled (true) or not (false).

• Type: boolean
• Required: No
• Description: Indicates whether a profile is used to create a PDF of an article from Cases (true) or not (false).

• Type: string[]
• Required: No

Represents the metadata used to manage settings for the languages enabled for Salesforce Knowledge.

Introduced in API version 28.0.

• Type: boolean
• Required: No
• Description: Indicates whether the language is enabled (true) or not (false).

• Type: string
• Required: No
• Description: The default assignee for articles in the language.

• Type: KnowledgeLanguageLookupValueType (enumeration of type string)
• Required: No
• Description: Indicates the default assignee type.
• Possible values:
  • User
  • Queue

• Type: string
• Required: No
• Description: The default reviewer for articles in the language.

• Type: KnowledgeLanguageLookupValueType (enumeration of type string)
• Required: No
• Description: Indicates the default reviewer type.
• Possible values:
  • User
  • Queue

• Type: string
• Required: Yes
• Description: 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.

A list of languages enabled for Salesforce Knowledge.

Introduced in API version 28.0.

• Type: KnowledgeLanguage[]
• Required: No
• Description: Represents the metadata used to manage settings for the languages enabled for Salesforce Knowledge.

Represents the metadata used to manage settings for Salesforce Knowledge and Sites.

• Type: string[]
• Required: No
• Description: Specifies the site used for Salesforce Knowledge and Sites.

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.

• Type: KnowledgeCaseFieldsSettings
• Required: No
• Description: Represents a list of the case fields used to suggest articles for the case.

• Type: boolean
• Required: No
• Description: Indicates whether case content is used to suggest articles for cases (true) or not (false).

• Type: KnowledgeWorkOrderFieldsSettings
• Required: No
• Description: Represents a list of the work order fields used to suggest articles for the work order.

• Type: KnowledgeWorkOrderLineItemFieldsSettings
• Required: No
• Description: Represents a list of the work order line item fields used to suggest articles for the work order line item.

Represents the name of the work order field used to suggest articles for the work order.

Introduced in API version 39.0.

• Type: string
• Required: No
• Description: Specifies the name of the work order field used to suggest articles for the work order.

Represents a list of the work order fields used to suggest articles for the work order.

Introduced in API version 39.0.

• Type: KnowledgeWorkOrderField[]
• Required: No
• Description: Specifies the names of the work order fields used to suggest articles for the work order.

Represents the name of the work order line item field used to suggest articles for the work order line item.

Introduced in API version 39.0.

• Type: string
• Required: No
• Description: Specifies the name of the work order line item field used to suggest articles for the work order line item.

Represents a list of the work order line item fields used to suggest articles for the work order line item.

Introduced in API version 39.0.

• Type: KnowledgeWorkOrderLineItemField[]
• Required: No
• Description: Specifies the names of the work order line item fields used to suggest articles for the work order line item.

This is a sample Knowledge settings file.

1<?xml version="1.0" encoding="UTF-8"?>
2<KnowledgeSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3    <answers>
4        <enableArticleCreation>false</enableArticleCreation>
5    </answers>
6    <cases>
7        <articlePDFCreationProfile>partner portal knowledge profile</articlePDFCreationProfile>
8        <articlePublicSharingSites>
9            <site>KnowledgeSite</site>
10            <site>PKB2Site</site>
11            <site>ChatterAnswersSite</site>
12        </articlePublicSharingSites>
13        <articlePublicSharingSitesChatterAnswers>
14            <site>ChatterAnswersSite</site>
15        </articlePublicSharingSitesChatterAnswers>
16        <assignTo>testall@kb.org</assignTo>
17        <defaultContributionArticleType>Support</defaultContributionArticleType>
18        <editor>simple</editor>
19        <enableArticleCreation>true</enableArticleCreation>
20        <enableArticlePublicSharingSites>true</enableArticlePublicSharingSites>
21        <useProfileForPDFCreation>true</useProfileForPDFCreation>
22    </cases>
23    <defaultLanguage>ja</defaultLanguage>
24    <enableCreateEditOnArticlesTab>true</enableCreateEditOnArticlesTab>
25    <enableExternalMediaContent>true</enableExternalMediaContent>
26    <enableKnowledge>true</enableKnowledge>
27    <showArticleSummariesCustomerPortal>true</showArticleSummariesCustomerPortal>
28    <showArticleSummariesInternalApp>true</showArticleSummariesInternalApp>
29    <showArticleSummariesPartnerPortal>true</showArticleSummariesPartnerPortal>
30    <showValidationStatusField>true</showValidationStatusField>
31    <suggestedArticles>
32      <caseFields>
33         <field>
34            <name>Subject</name>
35         </field>
36         <field>
37            <name>SuppliedEmail</name>
38         </field>
39      </caseFields>
40      <useSuggestedArticlesForCase>true</useSuggestedArticlesForCase>
41    </suggestedArticles>
42</KnowledgeSettings>

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. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.