sharepoint fields (site columns) title vs internalname vs static name

jasmeeners 0 Reputation points

sharepoint field DisplayName InternalName StaticName special character conversion

If you create a new site column (field) that contains blanks or special characters, through the sharepoint GUI, then microsoft will convert those characters when it generates the InternalName and StaticName.

For example,

DisplayName = "Test or Test(s)"

InternalName = StaticName = Test_x0020_or_x0020_Test_x0028_s_x0029_

However, if you use an API call to create the site column , for example Add-PnPField, it will allow you to create an InternalName that does not follow this convention. i.e. one that contains spaces and special characters


Add-PnpField -DisplayName "Test3 or Test(s)" -InternalName "Test3 or Test(s)" -Type Text

this will result in the following Field object:

DisplayName = "Test3 or Test(s)"

InternalName = "Test3 or Test(s)"

StaticName = Test3_x0020_or_x0020_Test_x0028_s_x0029_


  1. If you create a field object, with blanks and special characters will this cause problems in the operation of sharepoint?
  2. why does microsoft perform conversions of blanks and special characters?
  3. what is the best way to replicate this behaviour when using an API call to create a FIELD object?
  4. what is the best practice recommended by microsoft when creating a field object via an api call with regards to InternalName and Static Name
A group of Microsoft Products and technologies used for sharing and managing content, knowledge, and applications.
9,865 questions
SharePoint Development
SharePoint Development
SharePoint: A group of Microsoft Products and technologies used for sharing and managing content, knowledge, and applications.Development: The process of researching, productizing, and refining new or existing technologies.
2,713 questions
{count} votes

1 answer

Sort by: Most helpful
  1. RaytheonXie_MSFT 32,166 Reputation points Microsoft Vendor

    Hi @jasmeeners,

    Per my research, we haven't found any issue when use blanks in the internal name of sharepoint list column. For special characters, you could refer to following document:

    Restrictions and limitations in OneDrive and SharePoint

    The display name is the name that is shown to end user. The internal name is obtained from display name but all special characters and spaces are replaced with Unicode. As the sample in your case, the internal name will auto replace special characters with Unicode if you don't set it. But the internal name could be completely different from display name. For example, your display name is Test3 or Test(s), and your internal name could be any thing like abc or test abc. You can name it according to your preference.

    The best example to understand the internal name is the “Modified By” field which is having the internal name “Editor”. When you edit the column name and change it to something totally different, the internal name doesn’t change.

    If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.