"Special Tags" are used to display a custom waypoint name (Geocache Name Format in Advanced Options)
The special tags are converted to the corresponding information as described below:
%bear - Bearing from current centre point
%bgMap = British grid - the 2 character grid map
%bgEast = British grid - the 5 digit easting value
%bgNorth = British grid - the 5 digit northing value
%bug = Travel bug status (notes)
%by = Placed by
%code = Waypoint code (For example, the GCXXXX code)
%con = Container
%con1 = One letter indicating the container type (notes)
%correct = Corrected coordinate status (notes)
%database = The current database name
%crypt = The coded hint (I.E. encrypted)
%datelf - Date last found)
%datepl - Date placed
%dif = Difficulty in full
%dif1 = Difficulty reduced to 1 digit (dif * 2 -1), so 1=1, 1.5=2, 2=3, 2.5=4, ...
%dif1a - Difficulty reduced to 1 character, so 1=1, 1.5 = A, 2=2, 2.5=B, 3=3, 3.5=C, 4=4, 4.5=D, 5=5
%dist - Distance from current centre point
%dnf = Did not find status (notes)
%drop2 = Same as %code, but drops the first two characters (notes)
%found = Found status. (notes)
%foundbyme = Found by me date
%gcid = Geocaching.com Cache number. (notes)
%hint = The decoded hint
%last4 = Last 4 found/not found logs (notes)
%lat = Latitude - 4 different formats to choose from (notes)
%lon = Longitude - 4 different formats to choose from (notes)
%name = Cache name
%ownerID = Cache Owner ID
%ownerName = Cache Owner Name
%smart = GSAK "Unique Smart Name" (notes)
%shortname = Same as %smart but no guarantee of unique name (notes)
%ter = Terrain in full
%ter1 = Terrain reduced to 1 digit (dif * 2 -1), so 1=1, 1.5=2, 2=3, 2.5=4, ...
%ter1a - Terrain reduced to 1 character, so 1=1, 1.5 = A, 2=2, 2.5=B, 3=3, 3.5=C, 4=4, 4.5=D, 5=5
%typ = Cache type
%typ1 = One letter indicating the cache type (notes)
%user = User Data.
%user2 = User Data2
%UserNote = The full text of the user note (including the log section)
%UserLog = The full text of the user log section within the user notes
%UTMZone - The UTM zone
%UTMEast - The UTM Easting
%UTMNorth - The UTM Northing
Note: The tags %name, %by, %con, %typ, %smart, %hint, %crypt, %user, %dif, %ter also support the format %tag=nn. Where nn is the number of characters to include. For example %typ=3 would only include the first 3 characters of the cache type, so that a "Multi Cache" would be translated to "Mul"
%bug - If Cache contains a travel bug, returns Y, if not found returns N. This tag also support the syntax %bug=xx where the first character is used for "Has travel bug" and the second for "No travel bug". For example, if you would prefer the %bug tag to show an asterisk when a cache has a travel bug and an exclamation when not, the syntax would be %bug=*!
%con1 - letters used are as follows: R=regular, L=large, M=micro, S=Small, V=Virtual, and U=unknown. If the cache type is not stated, the letter used is U.
%correct - If waypoint has corrected coordinates, returns Y, otherwise returns N. This tag also support the syntax %correct=xx where the first character is used for "Has corrected coordinates" and the second for "No corrected coordinates". For example, if you would prefer the %correct tag to show an asterisk when a cache has corrected coordinates and an exclamation when not, the syntax would be %correct=*!
%dnf - DNF logged returns Y, if no DNF returns N. This tag also support the syntax %dnf=xx where the first character is used for DNF waypoints and the second for no dnf. For example, if you would prefer the %dnf tag to show an asterisk for found and an exclamation for not found the syntax would be %dnf=*!
%drop2 - allows you to generate waypoints similar to the GCXXXX ones but without the needless GC at the front. For example, the cache GCAF12 which is a large multi cache, could be generated with the tags of %con1%typ1%drop2 to yield LMAF12. All the other tags used in the description format are available (and vice versa), but whatever tags you use, the total length of the resulting waypoint will be chopped off at the setting for "Maximum characters".
%found - Found returns Y, if not found returns N. This tag also support the syntax %found=xx where the first character is used for found waypoints and the second for not found. For example, if you would prefer the %found tag to show an asterisk for found and an exclamation for not found the syntax would be %found=*!
%gcid - This will yield the actual Geocaching.com number of a cache. Every cache code (the GCXXXX) code actually has a corresponding number. There is a rather convoluted algorithm to calculate this number, but suffice to say if you just use %gcid GSAK will do this calculation for you. This can come in handy when using it in custom URLs that require the Geocaching.com cache number rather than the cache code. An example of this is the watch a cache URL. If you would like to add the "Watch a Cache" customer URL the syntax would be http://www.geocaching.com/my/watchlist.aspx?w=%gcid
%lat - Latitude. This tag supports %lat=x where x is one of 4 formats to choose from:
D=Decimal degrees
M=Decimal minutes
S=Decimal seconds
U=UTM
Note, without the format specified the default is decimal degrees so the following are equivalent: %lat and %lat=D
%last4 - Last 4 found/not found logs. Found = F, Not Found = N, No log = 0. For example, if the latest log was a not found, the next a found, and there were no more logs this tag would return NF00. Notes are not included in the %last4 tag.
%lon - Longitude. This tag supports %lon=x where x is one of 4 formats to choose from:
D=Decimal degrees
M=Decimal minutes
S=Decimal seconds
U=UTM
Note, without the format specified the default is decimal degrees so the following are equivalent: %lon and %lon=D
%smart - uses the calculated unique smart name from your database. For a complete overview of smart names please see the Smart Names topic. This tag also supports the form %smart=nn (but not when used in the maco language, only in the GUI) where nn is the number of characters for the smart name. For example if you only want six characters in your smart name, your tag should be %smart=6 (note that %smart=06 also works). However, unlike other special tags that just return the first nn characters of data %smart=nn will force a recalculation of your smart names to this length and make this the default length for your database - see Database=>Properties. If you do not require unique names, then please use the more efficient %ShortName tag instead.
%ShortName - very similar to the %smart tag with the sole exception that unique names are not guaranteed. This tag is far more efficient as there is no re calculation of the database if you change the length of your short names. This tag also supports the syntax %ShortName=nn
%typ1 - letters used are as follows: T=traditional, M=multi, B=letterbox hybrid, C=CITO, E=event, L=locationless, V=virtual, W=webcam, O=Other, G=Benchmark, R=Earth, I=Wherigo and U=mystery/Unknown.
Please note that the tags are not case sensitive.
Taken from GSAK help 7.5.2
j
