Network

Declarative Metadata File Suffix and Directory Location

Network components are stored in the networks directory of the corresponding package directory. The file name matches the community name, and the extension is .network.

Version

This object is available in API version 28.0 and later.

Fields

Field	Field Type	Description
allowedExtensions	string	Specifies the types of files allowed in your community. This whitelist of file types lets you control what your community members upload and also prevents spammers from polluting your community with inappropriate files. Available in API version 36.0 and later.
allowMembersToFlag	boolean	Determines whether users in the community can flag posts or comments as inappropriate. Flagged items are sent to a community moderator for review. Available in API version 29.0 and later.
branding	Branding	The color scheme, header, and footer used in the community.
caseCommentEmailTemplate	string	Email template used when notifying community members when a case comment has been modified or added to a case.
changePasswordTemplate	string	Email template used when notifying a user that their password has been reset.
description	string	Description of the community.
emailSenderAddress	string	Email address from which community emails are sent.
emailSenderName	string	Name from which community emails are sent.
enableGuestChatter	boolean	Specifies whether guest users can access public Chatter groups in the community without logging in.
enableInvitation	boolean	Determines whether users can invite others to the community.
enableKnowledgeable	boolean	Determines if community members can see who’s knowledgeable on topics and endorse people for their knowledge on a topic. Available in API version 30.0 and later.
enableNicknameDisplay	boolean	Determines if user nicknames display instead of their first and last names in most places in the community. Set to `false` by default. Available in API version 32.0 and later.
enablePrivateMessages	boolean	Determines if community members can send and receive private messages. Available in API version 30.0 and later.
enableReputation	boolean	Determines if reputation is calculated and displayed for community members. Available in API version 31.0 and later. If enabled, reputationLevels and reputationPointsRules are used. If no reputationLevels or reputationPointsRules are not defined in the data file, the default values are used.
enableSiteAsContainer	boolean	Determines whether the community uses Site.com pages instead of tabs.
forgotPasswordTemplate	string	The email template used when a user forgets their password.
maxFileSizeKb	int	Specifies the maximum file size (in KBs) that members can upload in your community. Available in API version 36.0 and later. Enter a number between 3072 KB and your org’s maximum file size. To use the default limit of 2 GB, leave this field empty.
navigationLinkSet	NavigationLinkSet	Represents the navigation menu in a community. A navigation menu consists of items that users can click to go to other parts of the community. This field is available in API version 37.0 and later.
networkMemberGroups	NetworkMemberGroups	The profiles and permission sets that have access to the community. Users with these profiles or permission sets are members of the community. If a Chatter customer (from a customer group) is assigned a permission set that is also associated with a community, the Chatter customer isn’t added to the community. Note
newSenderAddress	string	Email address that has been entered as the new value for EmailSenderAddress but has not been verified yet. After a user has requested to change the sender email address and has successfully responded to the verification email, the NewSenderAddress value overwrites the value in EmailSenderAddress. This becomes the email address from which community emails are sent.
picassoSite	string	Name of the Site.com site linked to the community.
reputationLevels	ReputationLevelDefinitions	The reputation levels assigned to members when they accrue points by performing certain actions.
reputationPointsRules	ReputationPointsRules	The points members accrue when they perform certain defined actions.
selfRegProfile	string	The profile assigned to users who self register. This value is used only if selfRegistration is enabled for the community. Available in API version 29.0 and later.
selfRegistration	boolean	Determines whether self-registration is available for the community.
sendWelcomeEmail	boolean	Determines whether a welcome email is sent when a new user is added to the community.
site	string	The CustomSite associated with the community.
status	NetworkStatus[]	Status of the community. Available values are: Live—The community is online and members can access it. DownForMaintenance—The community was previously published, but was taken offline. Members with “Create and Set Up Communities” can still access the setup for offline communities regardless of profile or membership. Members are not able to access offline communities, but they still appear in the user interface drop-down as CommunityName (Offline). UnderConstruction—The community has not yet been published. Users with “Create and Set Up Communities” can access communities in this status if their profile is associated with the community. Once a community is published, it can never be in this status again.
tabs	NetworkTabSet	The tabs that are available in the community. The user that created the community selected these tabs.
urlPathPrefix	string	The first part of the path on the site's URL that distinguishes this site from other sites. For example, if your site URL is mycompany.force.com/partners, then partners is the urlPathPrefix.
welcomeTemplate	string	The email template used when sending welcome emails to new community members.

Branding

Represents the branding and color scheme applied to the community.

Field	Field Type	Description
loginFooterText	string	The text that appears in the footer of the community login page.
loginLogo	string	The logo that appears on the community login page for external users.
pageFooter	string	An image that appears on the footer of the community pages. Must be an .html file.
pageHeader	string	An image that appears on the header of the community pages. Can be an .html, .gif, .jpg, or .png file.
primaryColor	string	The color used for the active tab.
primaryComplementColor	string	Font color used with primaryColor.
quaternaryColor	string	The background color for pages in the community.
quaternaryComplementColor	string	Font color used with quaternaryColor.
secondaryColor	string	The color used for the top borders of lists and tables.
tertiaryColor	string	The background color for section headers on edit and detail pages.
tertiaryComplementColor	string	Font color used with tertiaryColor.
zeronaryColor	string	The background color for the header.
zeronaryComplementColor	string	Font color used with zeronaryColor.

NavigationLinkSet

Represents the navigation menu in a community. A navigation menu consists of items that users can click to go to other parts of the community.

Field	Field Type	Description
navigationMenuItem	NavigationMenuItem[]	A list of menu items in a NavigationLinkSet. Use this object to create, delete, or update menu items in your community’s navigation menu.

NavigationMenuItem

Represents a single menu item in a NavigationLinkSet. Use this object to create, delete, or update menu items in your community’s navigation menu.

Field	Field Type	Description
defaultListViewId	string	If the value of the type field is `SalesforceObject`, the value is the ID of the default list view for the object.
label	string	Required. The text that appears in the navigation menu for this item.
position	int	Required. The location of the menu item in the navigation menu.
publiclyAvailable	boolean	When set to `true`, gives access to guest users.
subMenu	NavigationSubMenu	A list of child menu items. This field is available in API 39.0 and later.
target	string	Required if type is `ExternalLink`, `InternalLink`, or `SalesforceObject`. If type is `ExternalLink` or `InternalLink`, the target is the URL that the link points to. For `ExternalLink`, your entry looks like this: `http://www.salesforce.com`. For `InternalLink`, use a relative URL, such as `/contactsupport`. If type is `MenuLabel` or `NavigationalTopic`, target is not used.
targetPreference	string	Backed by a picklist that includes preferences for the target field. Valid values are: `None` `OpenInExternalTab`—Used for external links to determine whether to open in an external tab.
type	string	Required. The type of navigation menu item. Valid values are: `SalesforceObject`—Available objects include accounts, cases, contacts, and custom objects. `ExternalLink`—Links to a URL outside of your community. For example, `http://www.salesforce.com`. `InternalLink`—Links to a relative URL inside your community. For example, `/contactsupport`. `MenuLabel`—A parent heading for your navigation menu. See NavigationSubMenufor how to nest items underneath the menu label. This value is available in API 39.0 and later. `NavigationalTopic`—A drop-down list with links to the navigational topics in your community. You cannot nest other items of type `MenuLabel` or items of type `NavigationalTopic` under `MenuLabel`.

NavigationSubMenu

A list of child menu items. Only NavigationMenuItem items of type MenuLabel can have items in a NavigationSubMenu. Available in API 39.0 and later.

Field	Field Type	Description
navigationMenuItem	NavigationMenuItem[]	A list of menu items in a NavigationSubMenu. Use navigationMenuItem to create, delete, or update child items under a parent heading.

NetworkMemberGroup

Represents the profiles and permission sets that are assigned to the community. Users with one of the profiles or permission sets are members of the community, unless the user is a Chatter customer (from a customer group).

Field	Field Type	Description
permissionSet	string	A permission set that is assigned to the community. If a Chatter customer (from a customer group) is assigned a permission set that is also associated with a community, the Chatter customer isn’t added to the community. Note
profile	string	A profile that is part of the community.

ReputationBranding

Branding for the reputation level.

Field	Field Type	Description
smallImage	string	Custom image associated with a reputation level. Use files with these extensions: .jpeg, .png, or .gif. Images are stored as documents. If not specified, the default reputation level image is used. Available in API version 32.0 and later.

ReputationLevelDefinitions

Represents reputation levels members can achieve by performing certain defined actions in a community.

Field	Field Type	Description
level	ReputationLevel[]	Represents reputation levels.

ReputationLevel

Represents the name and lower value of the reputation level. The upper value is calculated by the application.

Field	Field Type	Description
branding	ReputationBranding[]	Represents any branding associated with the reputation level, specifically, the custom image for the reputation level. This field is optional. If not specified, the default reputation level image is used. Available in API version 32.0 and later.
label	string	Name of the reputation level. This field is optional. If not specified, one of the 10 defaults are used. Level 1 Level 2 Level 3 Level 4 Level 5 Level 6 Level 7 Level 8 Level 9 Level 10
lowerThreshold	double	Required. The lower value in the range for this reputation level. For example, if this reputation level is for points 1–50, 1 is the lowerThreshold.

Field

Field Type

Description

branding

ReputationBranding[]

Represents any branding associated with the reputation level, specifically, the custom image for the reputation level.

This field is optional. If not specified, the default reputation level image is used. Available in API version 32.0 and later.

label

string

Name of the reputation level.

This field is optional. If not specified, one of the 10 defaults are used.

Level 1
Level 2
Level 3
Level 4
Level 5
Level 6
Level 7
Level 8
Level 9
Level 10

lowerThreshold

double

Required. The lower value in the range for this reputation level. For example, if this reputation level is for points 1–50, 1 is the lowerThreshold.

ReputationPointsRules

Represents points rules in a community’s point system.

Field	Field Type	Description
pointsRule	ReputationPointsRule[]	Represents events and their associated points.

ReputationPointsRule

Represents the event and associated point value for a points rule. When a user acts, they accrue the associated points.

Field	Field Type	Description
eventType	string	Required. The type of event a member has to perform to get points. The available values are: `FeedItemWriteAPost` `FeedItemWriteAComment` `FeedItemReceiveAComment` `FeedItemLikeSomething` `FeedItemReceiveALike` `FeedItemMentionSomeone` `FeedItemSomeoneMentionsYou` `FeedItemShareAPost` `FeedItemSomeoneSharesYourPost` `FeedItemPostAQuestion` `FeedItemAnswerAQuestion` `FeedItemReceiveAnAnswer` `FeedItemMarkAnswerAsBest` `FeedItemYourAnswerMarkedBest` `FeedItemEndorseSomeoneForKnowledgeOnATopic` `FeedItemEndorsedForKnowledgeOnATopic`
points	int	Required. The number of points a member gets for performing the event. The default number of points per event is: FeedItemWriteAPost +1 FeedItemWriteAComment: +1 FeedItemReceiveAComment: +5 FeedItemLikeSomething: +1 FeedItemReceiveALike: +5 FeedItemMentionSomeone: +1 FeedItemSomeoneMentionsYou: +5 FeedItemShareAPost: +1 FeedItemSomeoneSharesYourPost: +5 FeedItemPostAQuestion: +1 FeedItemAnswerAQuestion: +5 FeedItemReceiveAnAnswer: +5 FeedItemMarkAnswerAsBest: +5 FeedItemYourAnswerMarkedBest: +20 FeedItemEndorseSomeoneForKnowledgeOnATopic: +5 FeedItemEndorsedForKnowledgeOnATopic: +20

NetworkTabSet

Field	Field Type	Description
customTab	string	Custom tab that is part of the community.
defaultTab	string	The Home tab for the community. When members log in, this tab is the first page they see.
standardTab	string	Standard tab that is part of the community.

Declarative Metadata Sample Definition

A sample XML definition of a network.

Metadata API Developer Guide