AprilTags are coded images similar to barcodes or QR codes. Using a webcam, robots can determine where they are in relation to the image by looking at the size and shape of the AprilTag.
Teams that want to use AprilTags to navigate the playing field should begin by printing PDF AprilTag images. Then, use the provided sample program to test the webcam and printed images. Finally, build off this program to make it your own!
Possible benefits include:
Allows teams to track robot translation (forward, right, left) and rotation (roll, yaw, pitch)
Knowing the location of the robot relevant to a goal can help teams release scoring elements more consistently
Drive team visibility of certain parts of the field may be limited
The 2026 FIRST Global Challenge — Igniting Innovation Robotics Challenge uses five AprilTags, labeled 100–104, located on the front and sides of each SUPPRESSION UNIT, and on the front face of the EXTINGUISHER.
Depending on where a robot is located on the playing field, multiple AprilTag images may be visible at the same time. Robots may use these AprilTags to assist in navigating around the field.
The following resources are required to use AprilTags:
Printed PDF files with the AprilTag images used on the playing field
Sample program for detecting and using AprilTags with Blocks or OnBot Java programming
Tag library (.jar file) containing information about the AprilTags used on the field
AprilTags for the 2026 FIRST Global Challenge – Igniting Innovation Robotics Challenge can be downloaded using the buttons below
The Igniting Innovation Robotics Challenge AprilTag library files, and Blocks and Java samples are available for download using the buttons below.
A PDF viewer is required to view and print the tags.
US and Canada printers (Letter 8.5 in x 11 in)
International (A4)
Here are examples of the correct print settings in Windows (left) and macOS (right):
After printing, check that the size of the marker (which includes the thin black border surrounding the black blocks) matches the size written at the bottom of the page (the thickness of the lines is included in the measurement). At close range, the distances reported by AprilTags should be accurate to within a few millimeters.
The 2026 FIRST Global REV Robotics Kit of Parts includes a Logitech C270 webcam for teams to use in the Igniting Innovation Robotics Challenge. To use the webcam, plug in the USB cable to one of the available USB ports on the Control Hub. The Logitech C270 is a USB 2.0 device, so it will work on either of the Control Hub's USB Ports.
Once the webcam is plugged in, it must be added to the robot configuration. For detailed information about creating or modifying a robot configuration, refer to the following documentation linked here:
An outline of the process is included below.
Save the .jar file on your computer and ensure it is named IgnitingInnovationAprilTagLibrary-1.0.jar
You can do this step using the REV Hardware Client or a web browser.
Selecting the AprilTag Library in Windows (Left) and macOS (Right)
Sample programs are available to provide an introduction to AprilTag programming. Teams may use portions of this code in their own programs.
The sample Blocks program (.blk file) detects all five AprilTag images and reports the webcam’s location relative to the image. Location is reported in three ways:
XYZ: Right, forward, and up distance (in centimeters) from the tag
PRY: Pitch, roll, and yaw (in degrees) relative to the tag
RBE: Range (in centimeters), bearing, and elevation (in degrees) relative to the tag
Before you begin, download the Igniting Innovation Robotics Challenge Blocks sample program using the button below:
The Logitech C270 webcam is calibrated at a resolution of 640x480. Although the resolution of the webcam can be set higher, this will disrupt the distance calculations performed by the AprilTag software. It is recommended that teams do not change the resolution in their code.
The sample program expects the robot configuration to include a webcam called Webcam, if your configuration does not include a webcam or it has a different name it will not work.
See the "Setting up the Webcam" section of the FGC AprilTag Guide for help creating a configuration.
The sample program is now available to run on the Driver Hub. Select IgnitingInnovationAprilTagBlocksSample from the second drop-down menu, and tap INIT.
Tap the play button to run the program. You can now hold the webcam in front of an AprilTag and read the information provided on the Driver Hub display. The sample program will list which AprilTag is visible and calculate the webcam’s location relative to the image.
The sample OnBot Java program (.java file) detects all five AprilTag images and reports the webcam’s location relative to the image. Location is reported in three ways:
XYZ: Right, forward, and up distance (in centimeters) from the tag
PRY: Pitch, roll, and yaw (in degrees) relative to the tag
RBE: Range (in centimeters), bearing, and elevation (in degrees) relative to the tag
Before you begin, download the Igniting Innovation Robotics Challenge Blocks sample program using the button below:
The sample program expects the robot configuration to include a webcam called Webcam, if your configuration does not include a webcam or it has a different name it will not work.
See the of the FGC AprilTag Guide for help creating a configuration.
This can be done using a web browser or the REV Hardware Client.
If the upload is successful, the sample program will appear in a folder called com.firstinspires.ftc.teamcode. You can select the file and click the build icon to build the sample program. The build was successful if the message Build SUCCESSFUL! appears in the bottom console.
The sample program is now available to run on the Driver Hub. Select EcoEquilibriumAprilTag sample from the second drop-down menu, and tap INIT.
Tap the play button to run the program. You can now hold the webcam in front of an AprilTag and read the information provided on the Driver Hub display. The sample program will list which AprilTag is visible and calculate the webcam’s location relative to the image.



















