Creating a Quick and Dirty Hit Counter
By Michael Smith
This article reprinted with permission from TeraTech and Miachael Smith. Copyright 1999-2000 TeraTech.
For more sign up for FusionAuthority's free weekly CF news alert.



Nowadays, having a hit counter on your website is essential -- to find out how many visitors come to your site, who they are, and if possible where they came from. Sometimes you want a hit counter on your page that you can control the format of (unlike the prebuilt free graphics hit counters that are out there). With ColdFusion, it is easy to create a simple hit counter, using a database to store the current count. Our first example only tracks how many times a page has been visited or refreshed. While this counter won't give you detailed statistics, you can easily modify your table to include columns for tracking items such as the visitor's IP address, browser type and referring page. We do this at the end of the article.


Creating Tables in ColdFusion

To get started, you will need a table in your database to store the number of hits. Just for fun, I will show you how to create a table using pure ColdFusion and SQL code. (Note: This table can be created even when you don't have direct access to your database. If you have direct access to your ColdFusion data source, then of course you can just create the table in your database by hand.)

The table in question, "hit_counter" (see Listing 1 below), stores the number of hits a web page has received in an integer field called hit_count, thus tracking the number of visits to your web page.

FTP the create table example below to your web server and run it by typing the name of the file into your browser. In this case, the file is called "createcounter.cfm". When the CFQUERY successfully creates your table, you will see the message "Table Created!" in your browser window.

Listing 1:
Syntax - createcounter.cfm


   <title>My Counter</title>

   <cfquery datasource="YOUR_DATASOURCE" name="create">
   create table hit_counter (hit_count int null)
   Table Created!


Note that you can also delete tables using the DROP TABLE command in SQL.

Listing 1.5
Syntax - DropCounter.cfm

   <title>My Counter</title>

   <cfquery datasource="YOUR_DATASOURCE" name="create">
   drop table hit_counter
   Table Dropped!


Listing 2 below shows how to update and display the results of your counter in your specified web page. In line A, we are checking to see how many "hits" are in our database. This is followed by a few CFIF queries which check the number and update the hit count in your database each time your web page is visited (or refreshed).

In line B, we are checking to see if a number exists in your database (i.e., at least "1"). When we created the table (in Listing 1) above, we did not insert a number into the database. The code below is required to allow for the case of there being no records in the counter. If we didn't do this, the hit_count variable would be null rather than 0, which would cause an error when we tried to use it in lines C and D. Using the query "CreateHit" below, your hit counter will start at "1" if it is brand new.

Line C displays the actual number of hits on the web page. And Line D will increment the current number of hits in our database to +1 for each new visitor to the web page.

Listing 2
To display the counter: Paste the following code into your web page:

A.   <cfquery name="GetHits" datasource="YOUR_DATASOURCE">
      SELECT hit_count FROM hit_counter

B.   <CFIF GetHits.recordcount is 0>
      <cfquery name="CreateHit" datasource="YOUR_DATASOURCE">
      INSERT hit_count( hit_count) VALUES (1)
      Hits: 0

C.   <cfelse>
      Hits: <CFOUTPUT query="GetHits">#hit_count#</cfoutput>

D.   <cfquery name="updateHits" datasource="YOUR_DATASOURCE">
      UPDATE hit_count SET hit_count = hit_count + 1

Using this simple hit counter will give you a good starting point, but I encourage you to modify the example code and add more information about your visitors to your database. Doing so will allow you to reap the rewards of this simple tracking device.

Complex Counting and User Tracking

Here is the code for a more complex counter. In this case, we want to save both every page hit and track individual customers. This code is typically placed in your application.cfm file that is run at the front of every page or in a header.cfm include file.

Listing 3

A. Identify user by cookie:
   <CFIF isdefined("Cookie.user_id")>
   <CFSET user_id=trim(Cookie.user_id)>
   <CFSET user_id="">

B. Get page referrer information:
   <CFSET address = cgi.remote_addr>
   <CFSET host = cgi.remote_host>
   <CFSET referer = cgi.http_referer>
   <CFSET agent = cgi.http_user_agent>
   <CFSET page = cgi.script_name>
   <CFIF NOT Len(host)>
   <CFSET host = "unknown">
   <CFIF NOT LEN(referer)>
   <CFSET referer = "unknown">

To track repeat visitors, we use a cookie called user_id. The code in section A checks to see if the cookie exists and copies the ID into a page variable called user_id. Otherwise, we default user_id to "", so that we won't get undefined variable errors later in the code.

Next, in code B, we set page variables for the user's IP address, machine name, etc., using the standard ColdFusion CGI variables. If you want to see a complete list of these variables, turn on debug on your CF server and look at the bottom of the page.


CGI variable Meaning Example
Remote_addr IP of user
Remote_host Machine name of user
http_referer Link this page came from
http_user_agent User's browser type Mozilla/4.7 [en] (WinNT; U)
Script_name File name of CFM file being run /press/CFConfAndByteBack.CFM

In addition to the user id, we give many of our users a variable called "custno" that may be passed on URL from a ColdFusion-generated email or via a session variable. In the latter case, we default the page variable "custno" to the session variable in part C.

Listing 3 (continued)

C. Track any customer by session:
   <CFIF not isdefined("custno")>
   <CFIF isdefined("session.custno")>
   <cfset custno = session.custno>

D. If user has not been here before, create ID and cookie for them:
   <CFIF NOT LEN(user_id)>
   <CFQUERY NAME="CreateUser" DATASOURCE="webserver">
     insert into ClientInfo (RemoteAddress, RemoteHost, Referer,UserAgent, page )
     values ('#address#', '#host#', '#referer#', '#agent#', '#page#')

   <CFQUERY NAME="MakeCookie" DATASOURCE="webserver">
     SELECT max(id) as high from clientinfo

   <CFOUTPUT QUERY="MakeCookie">
   <CFSET cook = high>
   <CFSET user_id = high>

   <CFCOOKIE NAME="user_id" VALUE="#cook#" EXPIRES="never">

Then, in D, we start creating the tracking records. For new users we create a ClientInfo record and a cookie based on the ID using the <CFCOOKIE> tag. For existing users we add a new record to the ClientTrack table for their userid (Section E). This way we can track every page a particular user visits.

Listing 3 (continued)

   E. Add tracking record for existing user:

   <CFQUERY NAME="TrackUser" DATASOURCE="webserver">
     insert into ClientTrack (Id, RemoteAddress, RemoteHost, Referer,UserAgent, page, custno)
     values ('#user_id#', '#address#', '#host#', '#referer#', '#agent#', '#page#',
   <CFIF isdefined("custno")>

Finally, in sections F, G and H, we set the "custno" session variable and update the ClientInfo database with the "custno", if it was passed in.

Listing 3 (continued)

   F. If custno variable passed in on URL (from email for example), save in user database:
      <CFIF isdefined("custno")>
      <CFQUERY NAME="UpdateUser" DATASOURCE="webserver">
      update ClientInfo
      <CFIF isdefined("custno")>
      set custno ='#custno#',
        set custno =custno,
      where ID = #user_id#
      <CFIF isdefined("custno")>
      <cfset session.custno = custno>

   G. Otherwise, try to set custno number from previous visit:
      <CFQUERY NAME="GetUser" DATASOURCE="webserver">
        SELECT custno, id
        FROM ClientInfo
        where ID = #user_id#

   H. Set session variable for use by other pages:
      <CFIF GetUser.custno is not "">
      <cfset session.custno = GetUser.custno>


We have covered how to code a simple hit counter and how to track more complete information about users. We mentioned dynamic table creation, the CGI variables, cookies and session variables. Good luck with tracking your users and have fun coding!

Michael is President of TeraTech, Inc., a maker of over 30 different tools and libraries for DOS and Windows programmers. In addition, TeraTech is a Premier Allaire Value-Added-Reseller and sponsors of the Maryland ColdFusion User Group. Their TeraTech ColdCuts site contains a wealth of tips & techniques and is an invaluable resource to the CF community. Michael can be reached via email at

About This Tutorial
Author: Michael Smith
Skill Level: Beginner 
Platforms Tested: CF5
Total Views: 174,053
Submission Date: August 19, 2002
Last Update Date: June 05, 2009
All Tutorials By This Autor: 1
Discuss This Tutorial
  • I keep getting an error, and it keeps trying to put a '0' in the custno field. Maybe it is because I am testing it on one page, but I don't know. Any advice?

  • MAX selects the maximum ID number in the database and sets it's variable name as high, so it can be called later in the code, instead of having to select max(id) once again when needed.

  • What is this code? What is max and as high? SELECT max(id) as high from clientinfo

  • What is SELECT max(id) as high in this query. I know Id is probably a column in the Clientinfo table but what is max and as high in this query? Andrew SELECT max(id) as high from clientinfo

  • I put Artist Bears on ebay for a friend. We tried using their FREE hit never worked. I have searched the internet for many hours looking for simple code for a hit counter that I can put at the bottom of the discription of each bear. Your page is the closest I have gotten but I don't want or need all the above bells and whistles that go along with the hit counter (and I don't know enough about html to figure it out for myself how to elliminate what isn't necessary). Do you know anywhere that I can get free code for a hit counter...I would be very grateful if you could help me. Thanks and God Bless You, Ruth McEwen


Sponsored By...
Mobile App Development (IOS, Android, Cordova, Phonegap, Objective-C, Java) - Austin, Texas Mobile Apps - Touch512, LLC.