{"title":"File.Rename(Text, Text) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/file/file-rename-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/file/file-rename-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/file/file-rename-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Renames an ASCII or binary file.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"File.Rename(Text, Text) Method","slug":"filerenametext-text-method","at":0,"chars":2402},{"level":2,"title":"Syntax","slug":"syntax","at":198,"chars":147},{"level":2,"title":"Parameters","slug":"parameters","at":345,"chars":874},{"level":2,"title":"Return Value","slug":"return-value","at":1219,"chars":238},{"level":2,"title":"Remarks","slug":"remarks","at":1457,"chars":119},{"level":2,"title":"Example","slug":"example","at":1576,"chars":694},{"level":2,"title":"Related information","slug":"related-information","at":2270,"chars":132}],"text":"# File.Rename(Text, Text) Method\n> Version: _Available or changed with runtime version 1.0._\nRenames an ASCII or binary file.\n> NOTE\n> This method is supported only in Business Central on-premises.\n## Syntax\n```al\n[Ok := ]  File.Rename(OldName: Text, NewName: Text)\n```\n> NOTE\n> This method can be invoked without specifying the data type name.\n## Parameters\nOldName\nType: ../text/text-data-type\nThe current name of the file that you want to change, including its path. When you enter the path, consider these shortcuts:\n You can omit the drive designation, if the file is located on the current drive.\n You can omit the full path, if the file is located in the current directory.\n You can enter only the subdirectory name, if the file is located in a subdirectory of the current directory.\nNewName\nType: ../text/text-data-type\nThe new name that you want to assign to the file, including its path. When you enter the path, consider these shortcuts:\n You can omit the drive designation, if the file is located on the current drive.\n You can omit the full path, if the file is located in the current directory.\n You can enter only the subdirectory name, if the file is located in a subdirectory of the current directory.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\n## Remarks\nTypically, the return value is false if the file does not exist, or if the file is a system or hidden file.\n## Example\nThe following example changes the name of a text file that is named Testfile.txt to NewTestFile.txt. The path of the file that is renamed is C:\\\\TestFolder\\\\Testfile.txt. The name and path are stored in the varOldFile variable. The new name and path of the file are stored the varNewfile variable. The RENAME method uses the variables to change the name of the file. This example assumes that you have created the following file on your computer: C:\\\\TestFolder\\\\Testfile.txt.\n```al\n var\n    varOldfile: Text;\n    varNewfile: Text;\nbegin\n    varOldfile := 'C:\\TestFolder\\Testfile.txt' ;\n    varNewfile := 'C:\\TestFolder\\NewTestFile.txt';\n    Rename(varOldfile, varNewfile);\nend;\n```\n## Related information\nfile-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}