# Viewing GeoPackage images in ArcGIS Pro The GeoPackage Related Tables extension establishes a relationship between three different tables: * A Feature table, with features that you want to store extra data on. * A Related table, which includes photos or other kinds of data related to features in the table above. * A Mapping table, which points to individual items in the Feature table and the Related table to tell the software that the two items are connected. For example, say we have a GeoPackage with one point feature class (Observations) that stores photos of noteworthy field conditions. When exporting from Touch GIS the GeoPackage will have three tables for this feature class and its images: * Observation (the Feature table) * Observation\_images (the Related table with all of your photo data) * Obervation\_Observation\_images\_map (the Mapping table) Here's a test GeoPackage file if you would like to follow the examples below exactly: {% file src="" %} ### Viewing related images in ArcGIS Pro At time of writing (April 2026) ArcGIS Pro does not directly support the GeoPackage Related Tables extension, neither does it allow us to directly view images from the blob data that the GeoPackage saves images in. When you load the GeoPackage file into a project, it will omit the mapping tables, but it should include the Related image tables. Exports from Touch GIS seed some extra data in the Related images table so that you can still manually relate the image records to features if desired. For example, the feature\_id column maps to the gpkg\_id column in the feature table. To work around these limitations and enable you to view your images directly in ArcGIS Pro we've developed [a public script and toolbox](https://github.com/mjroncone/arcgis-script-tools). This script takes your GeoPackage and creates a File Geodatabase from it. While doing this, it also reads the GeoPackage mapping tables to find all of the related images and uses ArcGIS' own tools to attach the images to the correct features inside of the Geodatabase. Once that's complete, you can select individual or groups of features and view them the Feature Pop-up or the Attributes Pane for selected features by looking for the tab labeled "Attachments". To take advantage of this, here are the steps: 1. Download the [gpkg-related-tables-tools.atbx](https://github.com/mjroncone/arcgis-script-tools/blob/main/gpkg-related-tables-tools.atbx) file. 1. Alternatively, if you're comfortable at the command line and prefer to have more control that way, clone the whole repository or download the attach-gpkg-related-media.py script. The README has instructions for interacting with the script and passing it the arguments that are needed. The end result is the same. 2. Open or create a new project in ArcGIS Pro, and add the toolbox to it along with the GeoPackage file with related images that you would like to view. 3. Open the toolbox and Double-click the "GeoPackage Related Media Helper" script. This will ask for three inputs: 1. The GeoPackage file. This file won't be altered in any way. The script only reads from it and copies the data into a File Geodatabase. 2. A File Geodatabase where you want to copy the GeoPackage data into, or alternatively a folder where the script can create a new Geodatabase. If you choose a folder, the new Geodatabase will have the same name as the GeoPackage, but with the `.gdb` extension. 3. A folder where it's safe for the script to temporarily store image files. In order to attach them to the Geodatabase using ArcGIS' `arcpy` toolset, the images need to be copied from the GeoPackage and saved to a folder. Then those separate image files can be attached to the Geodatabase, after which they can be deleted. 4. After selecting your inputs, run the script. Assuming it completes successfully, you can now add the Feature layers from the Geodatabase to your project. 5. View the images either by: 1. Using the Explore tool to click on individual features and scroll through the attachments carousel in the Pop-up. 2. Using the Attributes Pane and selecting features either with the Select Tool or in the Attributes Table for a layer. With a feature selected you should see an "Attachments" tab next to "Attributes" and "Geometry" which lists out the attached images. Double clicking on any image will open it for viewing. Reach out to if you're having trouble getting this to work: --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.touchgis.app/import-export/viewing-geopackage-images-in-arcgis-pro.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.