WallStreetMojo

WallStreetMojo

WallStreetMojo

MENUMENU
  • Blog
  • Free Video Tutorials
  • Courses
  • All in One Bundle
  • Login
Home » Excel, VBA & Power BI » Learn VBA » VBA Comment Block

VBA Comment Block

By Twinkle SethiTwinkle Sethi | Reviewed By Dheeraj VaidyaDheeraj Vaidya, CFA, FRM

Excel VBA Comment Block of Code

Comments in VBA programming are statements that are not executed or compiled but are only there to provide a brief description of any function, variable, statement, etc. These comments are not mandatory but are used so as to make the blocks of vba code more informative, readable, organized and easy to understand. Also, if we do not wish to delete certain lines of code, and neither want them to be executed, then we can comment on them.

VBA Block Comment

How to Comment on Block of VBA Code?

You can download this VBA Block Comment Template here – VBA Block Comment Template

Example #1 – Comment using Apostrophe

Let us say we wish to comment on a single line/statement/block in a VBA code. To do this, the Visual Basic Editor (VBE) has to be configured.

The Visual Basic Editor can be accessed as follows:

Go to the Excel Developer tab, and then click on Visual Basic Editor, or press Alt+F11 to open the Visual Basic Editor window.

VBA Block Comment Example 1

On doing this, a window opens as follows:

VBA Block Comment Example 1-1

Right-click on the workbook name in the ‘Project-VBAProject’ pane and then click on ‘Insert’-> ‘Module’ as follows.

VBA Block Comment Example 1-2

Now we can write our code or procedure in this module:

Code:

Sub macro()

 'This is a Comment

End Sub

VBA Block Comment Example 1-3

So we can see in the above screenshot that on writing this code in the module, we see that when we simply put or insert an apostrophe before a statement/line, then that statement turns into green text and is considered as a  comment. So, we see that when we wish to comment on a single line, it can simply be preceded with an apostrophe.

This method can also be used to comment on multiple lines by putting an apostrophe before each line as follows:

VBA Block Comment Example 1-4

Example #2 – Using Toolbar

Now, let’s say we wish to skip over and comment on an entire block of code, or multiple statements of the code. In such a case, using an apostrophe before each statement would be quite tedious and time-taking when we have so many statements to comment on. So to do this, there is a built-in option of ‘Comment/Uncomment Block’ in VBE that is initially hidden in the toolbar and can be used as follows:

Step 1: Select the Statements from code.

Select the statements in the macro/procedure that are required to be commented on below.

Popular Course in this category
Sale
VBA Training (3 Courses, 12+ Projects)
4.6 (247 ratings)
3 Courses | 12 Hands-on Projects | 43+ Hours | Full Lifetime Access | Certificate of Completion
View Course

VBA Block Comment Example 2

Step 2: Click on View -> Toolbars -> Customize

VBA Block Comment Example 2-1

Step 3: From Customize Window Click on Commands -> Edit, then select Comment Block

This will generate or open a ‘Customize’ pop-up window. Now click on ‘Commands’ -> ‘Edit’ and then click on ‘Comment Block’ and drag it to the toolbar as follows.

VBA Block Comment Example 2-2

With this, we now have the ‘Comment Block’ icon on the Toolbar for its easy access.

Now click on the ‘Comment Block’ from the toolbar as follows:

VBA Block Comment Example 2-3

In doing so, the highlighted statements/lines would now be commented and turn out to be green in color as below:

Code:

Sub CommentLines()

 'MsgBox "First Comment Line"
 'MsgBox "Second Comment Line"
 'MsgBox "Third Comment Line"

End Sub

VBA Block Comment Example 2-4

So we can see in the above screenshot that the green statements will not be executed by the macro and will only be treated as comments block.

Example #3 – Using REM Keyword

Another method that can be used to make a statement/line as a comment is to add the keyword ‘REM’ before it.

Let us see below how this works:

VBA Block Comment Example 3

We can see in the below screenshot that when the keyword ‘REM’ is added before the statement: ‘This is a comment,’ then it turns out to be green and hence a comment.

VBA BlockComment Example 3-1

Now let us see how this keyword can be used to comment multiple lines in the below screenshot.

Code:

Sub CommentUsingRem()

 Rem This is a Comment
 Rem This is a Comment
 Rem This is a Comment

End Sub

VBA BlockComment Example 3-2

So, we can see that apart from using apostrophe and ‘Comment Block,’ the keyword ‘REM” can also be used to comment statements of code or procedure. However, using the keyword ‘REM’ has some limitations:

  • Space is mandatory between the keyword ‘REM’ and the start of the statement.
  • It always has to be the first word to start with and cannot be used somewhere in the middle of a line/statement so as to comment rest of the line.

Example #4 – UnComment the Commented lines using Toolbar

Just the way we can comment a block of lines at one go, we can also uncomment the commented lines using the VBE built-in ‘Uncomment Block’ option in the same way as follows:

Select the commented statements in the macro/procedure that are required to be uncommented as below:

Block Comment Example 4

Now select ‘View -> ‘Toolbars’ -> ‘Customize’.

Example 4-1

This will generate or open a ‘Customize’ pop-up window. Now click on ‘Commands’ -> ‘Edit,’ and then click on ‘Uncomment Block’ and drag it to the toolbar as follows:

Example 4-2

With this, we now have the ‘Uncomment Block’ icon on the Toolbar for its easy access.

Now click on the ‘Uncomment Block’ from the toolbar as follows:

Example 4-3

In doing so, the highlighted statements that commented would now turn into executable statements of the code or procedure and change in color from green to black again as below:

Code:

Sub UncommentedLines()

 MsgBox "First Comment Line"
 MsgBox "Second Comment Line"
 MsgBox "Third Comment Line"

End Sub

VBA BlockComment Example 4-4

So these statements are no longer now comments.

Things to Remember

  • Comments are brief explanatory statements that can be used to describe the procedures.
  • Commenting can be useful in debugging the codes.
  • Any statement in the VBA code that follows an apostrophe is considered a comment.
  • As a good programming practice, comments can be used before each section of the code or before variable declarations and functions to describe their purpose.
  • The VBA Editor makes the statement’s font color as green to indicate that it is a comment.
  • Unless the apostrophe is present in a string, the compiler ignores the statement following an apostrophe until the end of the line.
  • An apostrophe can even be present somewhere in the middle of a line. Text after the apostrophe will be treated as a comment in that case.

The following screenshot illustrates this:

Apostrophe Comment

  • The comments do not affect code performance.
  • The comment symbol: Apostrophe’, or “REM” has to be used on each line if the comments require more than one line.
  • By default, the comments appear as green color in the code window.
  • The advantage of using apostrophe and ‘Comment Block’ over the keyword ‘REM’ is that they need less memory and space and are also easier to use.

Recommended Articles

This has been a guide to VBA Comment Block. Here we learn three ways to comment blocks of VBA codes using 1) Apostrophe, 2) Toolbar, 3) REM Keyword along with practical examples, and a downloadable excel template. Below you can find some useful excel VBA articles –

  • VBA Workbook Open
  • VBA RegEx
  • VBA Workbook Object
3 Shares
Share
Tweet
Share
VBA Training (3 Courses, 12+ Projects)
  • 3 Courses
  • 12 Hands-on Projects
  • 43+ Hours
  • Full Lifetime Access
  • Certificate of Completion
LEARN MORE >>
Primary Sidebar
Footer
COMPANY
About
Reviews
Contact
Privacy
Terms of Service
RESOURCES
Blog
Free Courses
Free Tutorials
Investment Banking Tutorials
Financial Modeling Tutorials
Excel Tutorials
Accounting Tutorials
Financial Statement Analysis
COURSES
All Courses
Financial Analyst All in One Course
Investment Banking Course
Financial Modeling Course
Private Equity Course
Venture Capital Course
Excel All in One Course

Copyright © 2021. CFA Institute Does Not Endorse, Promote, Or Warrant The Accuracy Or Quality Of WallStreetMojo. CFA® And Chartered Financial Analyst® Are Registered Trademarks Owned By CFA Institute.
Return to top

WallStreetMojo

Free Excel Course

Excel functions, Formula, Charts, Formatting creating excel dashboard & others

* Please provide your correct email id. Login details for this Free course will be emailed to you

Book Your One Instructor : One Learner Free Class
Let’s Get Started
Please select the batch
Saturday - Sunday 9 am IST to 5 pm IST
Saturday - Sunday 9 am IST to 5 pm IST

This website or its third-party tools use cookies, which are necessary to its functioning and required to achieve the purposes illustrated in the cookie policy. By closing this banner, scrolling this page, clicking a link or continuing to browse otherwise, you agree to our Privacy Policy

WallStreetMojo

Free Excel Course

Excel functions, Formula, Charts, Formatting creating excel dashboard & others

* Please provide your correct email id. Login details for this Free course will be emailed to you

Login

Forgot Password?

WallStreetMojo

Download VBA Block Comment Template

Special Offer - VBA Training Course (6 courses, 35+ hours video) View More