Number custom field

Static content types

Static content types come out of the box with Sitefinity CMS, such as Pages, Blogs, News, and so on.

To add a custom field to a content item, perform the following:

  1. Perform procedure Create custom fields » Step 1 to Step 5.
  2. In the Type dropdown box, select Number.
  3. In the Decimal places dropdown box, select the number of the decimal places you want to allow for this number field.
  4. Enter a name for the field.
    The name of the field is different from its label. The field's name serves as a reference for that field in the backend.
  5. If you select This is a hidden field checkbox, the custom field is not visible on the website or in the backend, and you can only use it in the code.
    You can later unhide the field by clicking it in the Custom fields section and changing the selection on the Appearance tab.
  6. In the Interface widget for entering data dropdown box, you select the widget which the creator or editor of the content item or page will use to complete the field.
    The default widget is Textbox. It displays an input field with labels and instructions.
  7. Expand the Advanced section if you want to change the database and the SQL database type of the custom field if you want to specify the name of the column of the database table where the custom field is added and whether the custom field is to be included in the database index.
    If the Allow empty values checkbox is selected, the field is not required and can be left empty. If you deselect it, the field becomes mandatory.
  8. Click Continue.
    A window appears where you must configure the appearance of the custom field, such as labels and instructions.

Label and texts

On this tab, perform the following:

  1. In the Label input field, enter the label of the textbox.
  2. If needed, in Instructional text, enter instructions or explanatory text for the textbox.
    The text is displayed when the content editor clicks the question mark icon in the backend when editing the item containing this custom field.
  3. If required, in Predefined value, enter a predefined value for the textbox that is displayed in the box by default and the user can change it.
  4. If required, in Unit, enter a string that will be displayed immediately after the number box. This is useful when the number denotes a unit value, such as km, MB, or USD.
  5. If you want to make the textbox mandatory, select the Make required checkbox.
    A textbox appears, where you enter the error message displayed if the user does not fill out the textbox.
  6. If you have a multilingual site, you can select or deselect the Make localizable checkbox.
    This allows you to translate the field into different language versions.
    By default, the checkbox is not selected.

Limitations

On this tab, perform the following:

  1. In Number of characters allowed, enter the minimum and maximum number of characters that a user can enter in the textbox.
    If you do not want to impose limits on the textbox, leave the Max input field empty and the Min input field 0.
  2. In Error message displayed when the entry is out of range, you enter the error message that Sitefinity CMS shows to the site users when they attempt to enter text with too much or too few characters.

Appearance

On this tab, perform the following:

  • If you do not want to display the custom field on all screens where you work with the content item, you can select the checkboxes of only those screens where you want the field to be displayed. To do this, select Some screens where you work with <content type> in the Backend… and select the screens where you want the custom field to appear.
  • NOTE: When you add a custom field to Images, Videos, or Document, this field is displayed on the upload screen when you upload items via the Image widget, Video widget, or Document link widget widgets. If you do not want to display the custom fields, deselect the upload screens.

  • If you have made the field a hidden field, the radio button Nowhere. This is a hidden field is selected when you open the field for editing. If you change the selection, the field is no longer hidden.
    If the field is not hidden, you can hide it by selecting Nowhere. This is a hidden field radio button.
  • In the CSS class input field, you can choose a class name for the custom field if later you want to set a CSS style for this particular field.

When finished, click Done.
The new field appears in the list of custom fields for the respective module.
If you want to delete a custom field, click .

Save your changes.

Dynamic content types

Dynamic content types are the ones you create using the Module Builder.

To add a custom field to a content item, perform the following:

  • Perform procedure Create custom fields » Step 1 to Step 5.
  • In the Type dropdown box, select Number.
  • In the Decimal places dropdown box, select the number of the decimal places you want to allow for this number field.
  • Enter a name for the field.
    The name of the field is different from its label. The field's name serves as a reference for that field in the backend.
  • If you select This is a hidden field checkbox, the custom field is not visible on the website or in the backend, and you can only use it in the code.
    IMPORTANT: Once you create a hidden field, you cannot edit its properties. Make sure you have configured all its properties before finishing creating it.
  • In the Interface widget for entering data dropdown box, you select the widget which the creator or editor of the content item or page will use to complete the field.
    The default widget is Textbox. It displays an input field with labels and instructions.
  • Expand the Advanced section if you want to change the database and the SQL database type of the custom field or if you want to specify the name of the column of the database table where the custom field is added.
    If the Allow empty values checkbox is selected, the field is not required and can be left empty. If you deselect it, the field becomes mandatory.
  • Click Continue.
    A window appears where you must configure the appearance of the custom field, such as labels and instructions.
  • General

    On this tab, perform the following:
    1. In the Label input field, enter the label of the textbox.
    2. If needed, in Instructional text, enter instructions or explanatory text for the textbox.
      The text is displayed when the content editor clicks the question mark icon in the backend when editing the item containing this custom field.
    3. If required, in Predefined value, enter a predefined value for the textbox that is displayed in the box by default and the user can change it.
    4. If required, in Unit, enter a string that will be displayed immediately after the number box. This is useful when the number denotes a unit value, such as km, MB, or USD.
    5. If you want to make the textbox mandatory, select the Make required checkbox.
      A textbox appears, where you enter the error message displayed if the user does not fill out the textbox.
    6. If you have a multilingual site, you can select or deselect the Make localizable checkbox.
      This allows you to translate the field into different language versions.
      By default, the checkbox is not selected.

    Limitations

    On this tab, perform the following:
    1. In Number of characters allowed, enter the minimum and maximum number of characters that a user can enter in the textbox.
      If you do not want to impose limits on the textbox, leave the Max input field empty and the Min input field 0.
    2. In Error message displayed when the entry is out of range, you enter the error message that Sitefinity CMS shows to the site users when they attempt to enter text with too much or too few characters.

    General

    On this tab, perform the following:

    1. In the Label input field, enter the label of the textbox.
    2. If needed, in Instructional text, enter instructions or explanatory text for the textbox.
      The text is displayed when the content editor clicks the question mark icon in the backend when editing the item containing this custom field.
    3. If you want to make the textbox mandatory, select the This is a required field checkbox.
      A textbox appears where you enter the error message displayed if the user does not fill out the textbox.
    4. If you have a multilingual site, select or deselect the More options » Make localizable checkbox.
      This allows you to translate the field into different language versions.
      By default, the checkbox is not selected.

    Limitations

    On this tab, perform the following:

    1. In Number of characters allowed, enter the minimum and maximum number of characters that a user can enter in the textbox.
      If you do not want to impose limits on the textbox, leave the Max input field empty and the Min input field 0.

    When finished, click Done.
    The new field appears in the list of custom fields for the respective module.
    If you want to delete a custom field, click .

    Save your changes.

    Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

    Web Security for Sitefinity Administrators

    The free standalone Web Security lesson teaches administrators how to protect your websites and Sitefinity instance from external threats. Learn to configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

    Foundations of Sitefinity ASP.NET Core Development

    The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

    Was this article helpful?