SiteDotCom | Metadata API Developer Guide

SiteDotCom extends the MetadataWithContent type and inherits its fullName and content fields.

Declarative Metadata File Suffix and Directory Location

SiteDotCom components are stored in the siteDotComSites directory of the corresponding package directory.

The file name for the metadata .xml file is [sitename]1.site-meta.xml. The file name for the site file is [sitename]1.site.

When a Lightning site is created, two sites are made behind the scenes: CustomSite (of type ChatterNetwork) and SiteDotComSite (of type ChatterNetworkPicasso). These sites are named, respectively, <site_name> and <site_name>1. The corresponding MDAPI file names are <site_name>.site-meta.xml and <site_name>1.site-meta.xml. 1 is appended to the SiteDotComSite type to keep the name unique from the corresponding CustomSite site.

There is a file size limitation when using the Metadata API to deploy a site from sandbox to production. The assets in the .site file can't be larger than 40 MB. The site gets created, but the assets show in the new site as broken. To fix the assets, export the assets from the sandbox environment separately and then import them into your new site.

Note

Version

SiteDotCom components are available in API version 30.0 and later.

Fields

Field	Field Type	Description
label	string	The name of the site that you’re deploying.
siteType	(enumeration of type string)	Required. Identifies whether the site is a ChatterNetworkPicasso site for Experience Cloud Sites, or a Siteforce site for Site.com sites.

Declarative Metadata Sample Definition

Here are two examples of a SiteDotCom XML definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<SiteDotCom xmlns="http://soap.sforce.com/2006/04/metadata">
3    <label>testsite</label>
4    <siteType>Siteforce</siteType>
5</SiteDotCom>
6
7
8<?xml version="1.0" encoding="UTF-8"?>
9<SiteDotCom xmlns="http://soap.sforce.com/2006/04/metadata">
10    <label>testCommunity</label>
11    <siteType>ChatterNetworkPicasso</siteType>
12</SiteDotCom>

Usage

You can only deploy a .site file retrieved in Summer ’19 or later. Older files aren’t supported.

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.