{"id":"sforce_api_objects_folder","title":"Folder","content":"<a name=\"sforce_api_objects_folder\"><!-- --></a><h1 class=\"helpHead1\"><span class=\"ph\" id=\"topic-title\"><a name=\"topic-title\"><!-- --></a>Folder</span></h1><div class=\"body refbody\">\n<div class=\"shortdesc\"><span class=\"ph\" id=\"summary\"><a name=\"summary\"><!-- --></a>Represents a repository for a Dashboard, Document, EmailTemplate,\n   Macro, QuickText, or Report. Only one type of item can be contained in a folder.</span></div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Supported Calls</h2>\n\n   \n   <p class=\"p\"><samp class=\"codeph nolang\">create()</samp>, <samp class=\"codeph nolang\">delete()</samp>,\n     <samp class=\"codeph nolang\">describeSObjects()</samp>, <samp class=\"codeph nolang\">getDeleted()</samp>, <samp class=\"codeph nolang\">getUpdated()</samp>, <samp class=\"codeph nolang\">query()</samp>, <samp class=\"codeph nolang\">retrieve()</samp>, <samp class=\"codeph nolang\">search()</samp>, <samp class=\"codeph nolang\">update()</samp>, <samp class=\"codeph nolang\">upsert()</samp></p>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Special Access Rules</h2>\n\n   \n   <ul class=\"ul bulletList\">\n    <li class=\"li\">You must have the “Modify All Data” permission to create, update, or delete\n     document folders and email template folders.</li>\n\n    <li class=\"li\">Guest and Customer Portal users can’t access this object.</li>\n\n    <li class=\"li\">To query this object, no special permissions are needed.</li>\n\n    <li class=\"li\">As of API version 35.0, when a folder is shared with a role, it is only visible to users in\n     that role. Superior roles in the role hierarchy don’t gain visibility.</li>\n\n    <li class=\"li\">If analytics folder sharing is turned on, then users need these permissions to create and\n     manage report folders and dashboard folders:<ul class=\"ul bulletList\">\n      <li class=\"li\">“<span class=\"keyword parmname\">Create Dashboard Folders</span>”</li>\n\n      <li class=\"li\">“<span class=\"keyword parmname\">Create Report Folders</span>”</li>\n\n     </ul>\n</li>\n\n    <li class=\"li\">To use folders for macros and quick text, enable folders for these objects in Setup on the\n     Macro Settings and Quick Text Settings pages.</li>\n\n   </ul>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Fields</h2>\n\n   \n   \n<div class=\"data colSort\"><table class=\"featureTable sort_table\" summary=\"\">\n     \n     \n     <thead class=\"thead sorted\" align=\"left\">\n      <tr>\n       <th class=\"featureTableHeader  \" id=\"d908277e138\">Field</th>\n\n       <th class=\"featureTableHeader  \" id=\"d908277e141\">Details</th>\n\n      </tr>\n\n     </thead>\n\n     <tbody class=\"tbody\">\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\">\n<span class=\"keyword parmname\">AccessType</span>\n       </td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Create, Filter, Group, Restricted picklist, Sort, Update</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Required. Indicates who can access the Folder. Available values include:<ul class=\"ul bulletList\">\n            <li class=\"li\">\n<samp class=\"codeph nolang\">Hidden</samp>—Folder is hidden from\n             everyone.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">Public</samp>—Folder is accessible by all\n             users.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">Shared</samp>—Folder is accessible only by a\n             User in a particular Group or UserRole. The API doesn’t allow you to view,\n             insert, or update which group or Role the Folder is shared with.</li>\n\n           </ul>\n<div class=\"box message info\"><div class=\"inner\"><div class=\"bd\"><div class=\"media\">\n<img class=\"img mtm\" src=\"/docs/resources/img/en-us/258.0?doc_id=images%2Ficon_note.png&folder=object_reference\" alt=\"Note\"><div class=\"mediaBd\">\n<h4 class=\"mbs\">Note</h4>\n<p>If analytics folder sharing is turned on for your organization, then this\n            field is present but not used.</p>\n</div>\n</div></div></div></div>\n</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\">\n<span class=\"keyword parmname\">DeveloperName</span>\n       </td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Create, Filter, Group, Nillable, Sort, Update</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The unique name of the object in the API. This name can contain only underscores and\n           alphanumeric characters, and must be unique in your org. It must begin with a letter, not\n           include spaces, not end with an underscore, and not contain two consecutive underscores.\n           In managed packages, this field prevents naming conflicts on package installations. With\n           this field, a developer can change the object’s name in a managed package and the changes\n           are reflected in a subscriber’s organization. Label is <strong class=\"ph uicontrol\">Folder Unique\n            Name</strong>.<div class=\"box message info\"><div class=\"inner\"><div class=\"bd\"><div class=\"media\">\n<img class=\"img mtm\" src=\"/docs/resources/img/en-us/258.0?doc_id=images%2Ficon_note.png&folder=object_reference\" alt=\"Note\"><div class=\"mediaBd\">\n<h4 class=\"mbs\">Note</h4>\n<p>When creating large sets of data, always specify a unique\n             <span class=\"keyword parmname\">DeveloperName</span> for each record. If no\n             <span class=\"keyword parmname\">DeveloperName</span> is specified, performance slows down while\n            Salesforce generates one for each record.</p>\n</div>\n</div></div></div></div>\n</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\">\n<span class=\"keyword parmname\">IsReadonly</span>\n       </td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">boolean</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Create, Defaulted on create, Filter, Group, Sort, Update</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Indicates whether this Folder is read-only (<samp class=\"codeph nolang\">true</samp>)\n           or editable (<samp class=\"codeph nolang\">false</samp>). Label is <kbd class=\"ph userinput\">Read\n            Only</kbd>.<div class=\"box message info\"><div class=\"inner\"><div class=\"bd\"><div class=\"media\">\n<img class=\"img mtm\" src=\"/docs/resources/img/en-us/258.0?doc_id=images%2Ficon_note.png&folder=object_reference\" alt=\"Note\"><div class=\"mediaBd\">\n<h4 class=\"mbs\">Note</h4>\n<p>If analytics folder sharing is turned on for your organization,\n            then this field is present but not used.</p>\n</div>\n</div></div></div></div>\n</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\">\n<span class=\"keyword parmname\">Name</span>\n       </td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Create, Filter, Group, idLookup, Sort, Update</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Label of the folder as it appears in the user interface. Label is <strong class=\"ph uicontrol\">Document\n            Folder Label</strong>.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\"><span class=\"keyword parmname\">NamespacePrefix</span></td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The namespace prefix that is associated with this object. Each Developer Edition org\n           that creates a managed package has a unique namespace prefix. Limit: 15 characters. You\n           can refer to a component in a managed package by using the <samp class=\"codeph nolang\"><var class=\"keyword varname\">namespacePrefix</var>__<var class=\"keyword varname\">componentName</var></samp>\n           notation. <p class=\"p\">The namespace prefix can have one of the following values.</p>\n<a name=\"namespace_prefix_values\"><!-- --></a><ul class=\"ul bulletList\" id=\"namespace_prefix_values\">\n            <li class=\"li\">In Developer Edition orgs, <span class=\"keyword parmname\">NamespacePrefix</span> is set to the\n             namespace prefix of the org for all objects that support it, unless an object is in an\n             installed managed package. In that case, the object has the namespace prefix of the\n             installed managed package. This field’s value is the namespace prefix of the Developer\n             Edition org of the package developer.</li>\n\n            <li class=\"li\">In orgs that are not Developer Edition orgs, <span class=\"keyword parmname\">NamespacePrefix</span> is\n             set only for objects that are part of an installed managed package. All other objects\n             have no namespace prefix.</li>\n\n           </ul>\n</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\"><span class=\"keyword parmname\">ParentId</span></td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Create, Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">ID of the parent object, if any.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d908277e138\" data-title=\"Field\">\n<span class=\"keyword parmname\">Type</span>\n       </td>\n\n       <td class=\"entry\" headers=\"d908277e141\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Create, Filter, Group, Restricted picklist, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Required. Type of objects contained in the Folder. This field can’t be updated.\n           Available values include: <ul class=\"ul bulletList\">\n            <li class=\"li\"><samp class=\"codeph nolang\">Dashboard</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Document</samp></li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">Email</samp> (for Salesforce Classic email\n             templates)</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">EmailTemplate</samp> (for Lightning email\n             templates)</li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Macro</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">QuickText</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Report</samp></li>\n\n           </ul>\n\n          </dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n     </tbody>\n\n    </table></div>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Usage</h2>\n\n   \n   <p class=\"p\">Only one type of item can be contained in a folder, either Dashboard, Document, EmailTemplate,\n    Macro, QuickText, or Report.</p>\n\n  </div>\n\n </div><div id=\"sfdc:seealso\" class=\"related-links\">\n<div class=\"relinfo\">\n<h4>See Also</h4>\n<ul class=\"unstyled\"><li><div><a class=\"link\" href=\"atlas.en-us.258.0.object_reference.meta/object_reference/sforce_api_objects_concepts.htm\" title=\"Salesforce objects and fields are analogous to database tables and the table columns. Objects and fields structure data. For example, the central object in the Salesforce data model represents accounts—companies and organizations involved with your business, such as customers, partners, and competitors.\">Overview of Salesforce Objects and Fields</a></div></li></ul>\n</div>\n</div>"}