Edit Article

How to Create a User Defined Function in Microsoft Excel

Community Q&A

Create a new workbook. Open the Visual Basic Editor and add a new Module. Create the function's "header" or "prototype" and add its code. Return to your workbook, start a cell's with an "=" followed by the function's name. Use the function a few times to ensure that it works properly.


  1. 1
    Create a new workbook or open the workbook in which you want to use your newly created User Defined Function (UDF).
  2. 2
    Open the Visual Basic Editor which is built into Microsoft Excel by going to Tools->Macro->Visual Basic Editor (or pressing Alt+F11).
  3. 3
    Add a new Module to your workbook by clicking in the button shown. You can create the user defined function in the Worksheet itself without adding a new module, but that will make you unable to use the function in other worksheets of the same workbook.
  4. 4
    Create the "header" or "prototype" of your function. It has to have the following structure:

    public function "The Name Of Your Function" (param1 As type1, param2 As type2 ) As return Type It can have as many parameters as you want, and their type can be any of Excel's basic data types or object types as Range. You may think of parameters as the "operands" your function will act upon. For example, when you say SIN(45) to calculate the Sine of 45 degree, 45 will be taken as a parameter. Then the code of your function will use that value to calculate something else and present the result.
  5. 5
    Add the code of the function making sure you 1) use the values provided by the parameters; 2) assign the result to the name of the function; and 3) close the function with "end function". Learning to program in VBA or in any other language can take some time and a detailed tutorial. However, functions usually have small code blocks and use very few features of a language. The more useful elements of the VBA language are:
    1. The If block, which allows you to execute a part of the code only if a condition is met. For example:

      Public Function Course Result(grade As Integer) As String
        If grade >= 5 Then
          CourseResult = "Approved"
          CourseResult = "Rejected"
        End If
      End Function

      Notice the elements in an If code block: IF condition THEN code ELSE code END IF. The Else keyword along with the second part of the code are optional.
    2. The Do block, which executes a part of the code While or Until a condition is met. For example:

      Public Function IsPrime(value As Integer) As Boolean
        Dim i As Integer
        i = 2
        IsPrime = True
          If value / i = Int(value / i) Then
            IsPrime = False
          End If
          i = i + 1
        Loop While i < value And IsPrime = True
      End Function

      Notice the elements again: DO code LOOP WHILE/UNTIL condition. Notice also the second line in which a variable is "declared". You can add variables to your code so you can use them later. Variables act as temporary values inside the code. Finally, notice the declaration of the function as BOOLEAN, which is a datatype that allows only the TRUE and FALSE values. This method of determining if a number is prime is by far not the optimal, but I've left it that way to make the code easier to read.
    3. The For block, which executes a part of the code a specified number of times. For example:

      Public Function Factorial(value As Integer) As Long
        Dim result As Long
        Dim i As Integer
        If value = 0 Then
          result = 1
        ElseIf value = 1 Then
          result = 1
          result = 1
          For i = 1 To value
            result = result * i
        End If
        Factorial = result
      End Function

      Notice the elements again:FOR variable = lower limit TO upper limit code NEXT. Also notice the added ElseIf element in the If statement, which allows you to add more options to the code that is to be executed. Finally, notice the declaration of the function and the variable "result" as Long. The Long datatype allows values much larger than Integer.

      Shown below is the code for a function that converts small numbers into words.
  6. 6
    Go back to your workbook and use the function by starting the content of a cell with an equal sign followed by the name of your function. Append to the name of the function an opening parenthesis, the parameters separated by commas and a final closing parenthesis. For example:


    You can also use your user defined formula by looking for it in the User Defined category in the Insert Formula wizard. Just click in the Fx button located to the left of the formula bar. The parameters can be of three types:
    1. Constant values typed directly in the cell formula. Strings have to be quoted in this case.
    2. Cell references like B6 or range references like A1:C3 (the parameter has to be of the Range datatype)
    3. Other functions nested inside your function (your function can also be nested inside other functions). I.e.: =Factorial(MAX(D6:D8))
  7. 7
    Verify the result is Ok after using the function several times to ensure it handles different parameter values correctly:

Community Q&A

Add New Question
  • How do I know what to write as the function code?
    wikiHow Contributor
    In order to create functions, you need a skill called "programming". Excel macros are written in a language called "Visual Basic for Applications", which you will need to learn to be able to write macros. It's quite easy once you've got the hang of it though!
  • How can I do well in exams?
    wikiHow Contributor
    Read the directions several times, leaving time for you to absorb between readings. Also practice writing VBA to do various things.
Unanswered Questions
Show more unanswered questions
Ask a Question
200 characters left



  • Whenever you write a block of code inside a control structure like If, For, Do, etc. make sure you indent the block of code using a few blank spaces or tab (the style of indentation is up to you). That will make your code easier to understand and you'll find a lot easier to spot errors and make improvements.
  • If you don't know how to write the code for a function, read How to Write a Simple Macro in Microsoft Excel.
  • Sometimes, a function may not require all the parameters to calculate a result. In that case you can use the keyword Optional before the name of the parameter in the function header. You can use the function IsMissing(parameter_name) inside the code to determine if the parameter was assigned a value or not.
  • Use a name that's not already defined as a function name in Excel or you'll end up being able to use only one of the functions.
  • Excel has many built in functions and most calculations can be done by using them either independently or in combination. Make sure you go through the list of available functions before you start coding your own. Execution may be faster if you use the built in functions.


  • Due to security measures, some people may disable macros. Make sure you let your colleagues know the book you're sending them has macros and that they can trust they're not going to damage their computers.
  • The functions used in this article are, by no means, the best way to solve the related problems. They were used here only to explain the usage of the control structures of the language.
  • VBA, as any other language, has several other control structures besides Do, If and For. Those have been explained here only to clarify what kind of things can be done inside the function source code. There are many online tutorials available where you can learn VBA.

Article Info

Categories: Microsoft Excel

In other languages:

Español: crear una función definida por el usuario en Microsoft Excel, Português: Criar uma Função Definida pelo Usuário no Microsoft Excel, Русский: создать пользовательскую функцию в Microsoft Excel, Italiano: Creare una Funzione Personalizzata in Microsoft Excel, Deutsch: In Microsoft Excel eine benutzerdefinierte Funktion erstellen

Thanks to all authors for creating a page that has been read 478,413 times.

Did this article help you?