Excel VBA Rename File – Change File Name

How to Rename a file using Excel VBA?

You can find a lot of function used in VBA under the object ‘VBA’.

This vba rename file is one of those few functions that exists outside of ‘VBA’ & it can be used directly as mentioned below:

  • Function Name: Name
  • Syntax: Name OldName As NewName

Here is a VBA code example that shows how to change the name of a file.

Excel VBA Code to Rename file

From any Excel workbook, press Alt F11 to view the VB editor.

Then copy paste the below code & change the example file name to a file that exists in your computer.

Sub ExcelVBAChangeFileName()
    Dim sExistingFileName As String
    Dim sRenamedTo As String
    
    'File to be renamed
    sExistingFileName = "D:\Filename1.txt"
    
    'New Name for the file
    sRenamedTo = "D:\Filename2.txt"
    
    'VBA command to Rename file
    Name sExistingFileName As sRenamedTo
End Sub

You cannot run this code twice. Because the old file will not exist after the first run.

So, press F5 only once to check this code.

Error Conditions while changing File Name

Before changing a file name, You could also include a condition to check if the old file exists. Also, check if the new file name already exists.

External reference: Here is a discussion related to file rename using Excel vba.

If the new file already exists, then the renaming step will fail. In that case the use can be intimated with appropriate message.

Once the command is executed fine, You can go to the folder and verify that the old file does not exist.

Alternate Solution to Rename file in Vba:

If this does not workout, You can write a code that will read the file content & write it into a new file.

Once the content is written to new file, the old file can be deleted (get file delete code here)

So, technically the old file will not exist & logically it is renamed to a different filename.