--- schema_version: "1" id: 7fd46c52aa284e7a78fe8370f535252ef326553190e6c2a37a5becd21e6e8aa3 title: Scontrol collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_scontrol.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_scontrol.htm source_site: developer.salesforce.com content_type: documentation content_hash: 70b9ddeafbc1a63e3c9efd4993b294caf4a81bff59437df118a99f45a727b96b description: A custom s-control, which is custom content that is hosted by the system but executed by the client application. --- # Scontrol A custom s-control, which is custom content that is hosted by the system but executed by the client application. ![Important](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note_important.png) #### Important Visualforce pages supersede s-controls. Organizations that haven’t previously used s-controls can’t create them. Existing s-controls are unaffected, and can still be edited. We recommend that you move your s-controls to Visualforce. We continue to support the Scontrol object. Represents a custom s-control, which is custom content that the system hosts, but client applications execute. An s-control can contain any type of content that you can display or run in a Web browser. ## Supported Calls create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), update(), upsert() ## Special Access Rules - Your organization must be using Enterprise, Developer, or Unlimited Edition and be enabled for custom s-controls. - Customer Portal users can’t access this object. ## Fields | Field | Details | | --- | --- | | Binary | Type base64 Properties Create, Nillable, Update Description Binary content of this custom s-control, such as an ActiveX control or a Java archive. Can be specified when created, but not when updated. Limit: 5 MB. | | BodyLength | Type int Properties Filter, Group, Sort Description The length of the custom s-control. Label is **Binary Length**. | | ContentSource | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Specifies the source of the s-control content, either custom HTML, a snippet (s-controls that are included in other s-controls), or a URL. | | Description | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Description of the custom s-control. | | DeveloperName | Type string Properties Create, Filter, Group, Sort, Update Description The unique name of the object in the API. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. In managed packages, this field prevents naming conflicts on package installations. With this field, a developer can change the object’s name in a managed package and the changes are reflected in a subscriber’s organization. Label is **S-Control Name**. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note When creating large sets of data, always specify a unique DeveloperName for each record. If no DeveloperName is specified, performance slows down while Salesforce generates one for each record. | | EncodingKey | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description Picklist of character set encodings, including ISO-08859-1, UTF-8, EUC, JIS, Shift-JIS, Korean (ks\_c\_5601-1987), Simplified Chinese (GB2312), and Traditional Chinese (Big5). | | Filename | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description An uploaded object to display when the custom s-control is added to a custom link. Can be a Java applet, an ActiveX control, or any other type of desired content. | | HtmlWrapper | Type textarea Properties Create, Update Description Required. HTML page that will be delivered when the user views this custom s-control. This HTML page can be the entire content of the custom s-control, or it can reference the binary. Limit: 1,048,576 characters. Label is **HTML Body**. | | Name | Type string Properties Create, Filter, Group, Sort, Update Description Required. Name of this custom s-control. Label is **Label**. | | NamespacePrefix | Type string Properties Filter, Group, Nillable, Sort Description The namespace prefix that is associated with this object. Each Developer Edition org that creates a managed package has a unique namespace prefix. Limit: 15 characters. You can refer to a component in a managed package by using the namespacePrefix\_\_componentName notation. The namespace prefix can have one of the following values. - In Developer Edition orgs, NamespacePrefix is set to the namespace prefix of the org for all objects that support it, unless an object is in an installed managed package. In that case, the object has the namespace prefix of the installed managed package. This field’s value is the namespace prefix of the Developer Edition org of the package developer. - In orgs that are not Developer Edition orgs, NamespacePrefix is set only for objects that are part of an installed managed package. All other objects have no namespace prefix. | | SupportsCaching | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the s-control supports caching (true) or not (false). | ## Usage Use custom s-controls to manage custom content that extends application functionality. All users can view custom s-controls, but the “Customize Application” permission is required to create or update custom s-controls. #### See Also - [Overview of Salesforce Objects and Fields](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_concepts.htm "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.")