---
schema_version: "1"
id: 1cb691e5f66943ffb7984b2a69343c9c1bb26c800c63574ba9795e95b4e040ae
title: Custom S-Control Attributes
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/dev_scontrol_fields.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.dev_scontrol_fields.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8f0be722879756e27bb5dc73fdc8e509d5c6754b2294fc0de344c269f5dbe299
description: Find out about custom S-Control attributes.
products:
  - Salesforce Platform
release: "264"
---
# Custom S-Control Attributes

Find out about custom S-Control attributes.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Salesforce Classic</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Contact Manager</strong>, <strong>Group</strong>, <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
      <colgroup>
        <col style="width:23.076923076923077%">
        <col style="width:76.92307692307693%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d31455e80">Attribute Name</th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d31455e83">Description</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Label</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">The text that displays on page layouts for embedded
            s-controls.</td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">S-Control Name</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">
            <span id="dev_scontrol_fields__field_name_desc"><a name="dev_scontrol_fields__field_name_desc"><!-- --></a>The unique name for the s-control. 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.</span>
          </td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Type</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">
            <p>Determines how you plan to use the s-control.</p>
            <dl>
              <dt style="font-weight:bold;padding-top:.25rem;">HTML</dt>
              <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Select this option if you want to enter the content for your
                s-control in the <samp class="parmname">Content</samp> area.</dd>
              <dt style="font-weight:bold;padding-top:.25rem;">URL</dt>
              <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Select this option if you want to enter the link or URL of
                an external website in the <samp class="parmname">Content</samp>
                area.</dd>
              <dt style="font-weight:bold;padding-top:.25rem;">Snippet</dt>
              <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Snippets are s-controls that are designed to be included in
                other s-controls. Select this option if you want to enter
                the content for your s-control snippet in the
                <samp class="parmname">Content</samp> area.
              </dd>
            </dl>
          </td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Description</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">Text that describes the s-control. This only displays to
            administrators.</td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Content</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">
            <p>Enter the content or source for your s-control. You can enter up to 1
              million characters. The HTML code defines exactly how your users should
              view the custom s-control. </p>
            <ul>
              <li>If you are building a formula in the <strong class="uicontrol">Advanced
                  Formula</strong> tab or for approvals or rules, such as
                workflow, validation, assignment, auto-response, or escalation,
                click <strong class="uicontrol">Insert Field</strong>, choose a field, and
                click <strong class="uicontrol">Insert</strong>. <p>To create a basic
                  formula that passes specific Salesforce data, select the
                  <strong class="uicontrol">Simple Formula</strong> tab, choose the
                  field type in the <samp class="parmname">Select Field Type</samp>
                  drop-down list, and choose one of the fields listed in the
                  <samp class="parmname">Insert Field</samp> drop-down list. Build
                  cross-object formulas to span to related objects and
                  reference merge fields on those objects.
                </p>
              </li>
              <li>To insert an operator, choose the appropriate operator icon from
                the <samp class="parmname">Insert Operator</samp> drop-down list.</li>
              <li>To insert a function, double-click its name in the list, or
                select it and click<strong class="uicontrol"> Insert Selected
                  Function</strong>. To filter the list of functions,
                choose a category from the <samp class="parmname">Functions</samp>
                drop-down list. Select a function and click <strong class="uicontrol">Help on
                  this function</strong> to view a description and examples
                of formulas using that function.</li>
              <li>To reference a file that you uploaded in the
                <samp class="parmname">Filename</samp> field as part of the custom
                s-control, select Custom S-Control from the <samp class="parmname">Select
                  Field Type</samp> drop-down list, and choose Custom
                S-Control URL to get the merge field for it. For a Java applet,
                you can also use the
                <samp class="parmname">{!Scontrol_JavaCodebase}</samp> merge field
                and the <samp class="parmname">{!Scontrol_JavaArchive}</samp> merge
                field.
              </li>
              <li>To insert activity merge fields, select
                <strong class="uicontrol">Event</strong> or <strong class="uicontrol">Task</strong>
                from <samp class="parmname">Select Field Type</samp>.
              </li>
            </ul>
            <p>Internet standards require special encoding for URLs. Salesforce
              encodes the text from any merge field you insert into a link. Encode
              extra text in your link manually. For example, to generate the
              following
              URL:</p>
            <pre class="line-numbers slds-box slds-box_x-small slds-theme_shade slds-m-top_medium slds-m-bottom_medium slds-scrollable_x"><code>http://www.google.com/search?q={!user.name} Steve Mark 50%</code></pre>
            <pre class="line-numbers slds-box slds-box_x-small slds-theme_shade slds-m-top_medium slds-m-bottom_medium slds-scrollable_x"><code>http://www.google.com/search?q={!user.name}+Steve+Mark+50%25</code></pre>
            <p style="margin-bottom:0;">Salesforce
              strips double quotes from URLs when the content source is a URL. If
              you must use double quotes, encode them manually. For example, to
              generate the URL
              <samp class="filepath">http://www.google.com/search?q="salesforce+foundation"</samp>,
              use this content:
              <samp class="filepath">http://www.google.com/search?q=%22salesforce+foundation%22</samp>
            </p>
          </td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Filename</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">Upload a file to display when you add this custom s-control to a
            custom link. The file can contain a Java applet, Active-X control, or
            any other type of content. This option applies to HTML s-controls
            only.</td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Prebuild In Page</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">This option keeps the s-control in memory, which may improve
            performance when the page is reloaded because the s-control does not
            have to be reloaded. This option applies to HTML s-controls
            only.</td>

        </tr>
        <tr class="">
          <td data-label="Attribute Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e80 ">
            <samp class="parmname">Encoding</samp>
          </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d31455e83 ">The default encoding setting is Unicode (UTF-8). Change it if you are
            passing information to a URL that requires data in a different format.
            This option is available when you select URL for the
            <samp class="parmname">Type</samp>.
          </td>

        </tr>
      </tbody>
    </table>

#### See Also

- [About S-Controls](https://help.salesforce.com/s/articleView?id=platform.dev_about_scontrols.htm&release=264.0.0&type=5 "Use s-controls to add your own functionality to your Salesforce organization. Whether you are integrating a hosted application of your own or are extending your current Salesforce user interface, use s-controls to store your code or refer to code elsewhere. Custom s-controls can contain any type of content that you can display in a browser, for example a Java applet, an Active-X control, an Excel file, or a custom HTML Web form.")
- [Useful S-Controls](https://help.salesforce.com/s/articleView?id=platform.dev_useful_scontrols.htm&release=264.0.0&type=5 "Use these samples to get started using s-controls.")
- [Tips on Building S-Controls](https://help.salesforce.com/s/articleView?id=platform.dev_tips_on_building_scontrols.htm&release=264.0.0&type=5 "Use these tips when building s-controls.")