Skip to Main Content
It looks like you're using Internet Explorer 11 or older. This website works best with modern browsers such as the latest versions of Chrome, Firefox, Safari, and Edge. If you continue with this browser, you may see unexpected results.

FL-Islandora Guide

A guide for FL-Islandora users.

Object Report

Object counts appear in the Report tab.  Since May of 2018, the "Report" tab, to the right of the "Manage" tab, provides the ability to produce viewable and downloadable .csv object counts that meet selection criteria. The "Report" tab is available to all authorized account holders, except site_submitter. You can obtain counts, by Content Model and Collection, of all objects in your repository, or of all objects in a specific collection. While the "Report" tab has been available from the start, prior to May 2018 the counts reported were of "parent" objects (e.g., books, serials, compound objects), but that functionality has been expanded to provide counts of both "parent" and "child" objects (e.g., books and book pages, etc.). This provides the ability to report on the actual number of files contained in a given site, broken down by Content Model, along with a total of all objects and files in the repository.

What information is in the "Report" tab?

The "Report" tab gives a total count of collection contents. It counts all objects, including individual Book Pages, Newspaper Pages, Newspaper Issues, and Serial PDFs. Those objects are often hidden from counts, because each is a component of something bigger. For example, a Book is more visible and most other searches and reports will give information about the Book but no information about individual pages.

The best way to use the "Report" tab is to count objects that don't show up when you download a .csv file of site content. For example, the "Report" tab is the only way to count Newspaper Issues (see "Report" tab column labeled "newspaper issue") and total number of PDFs in a Serial (see "Report" tab column labeled "serial pdf"). This can be useful when you have digitized a large newspaper. In an annual report, you can say "digitized 1 newspaper, with 689 issues and 5798 pages". That gives a better sense of the scale than does "digitized 1 newspaper".

How to use the "Report" tab:

1. Click to the Collection you want to find info about. (The Report tab is only available from a Collection; The Report tab is not available from title-level objects such as newspaper or serial titles.) You can run the report from you home collection, and you will get a breakdown of every collection on your entire site.

2. Look along the top of the collection for the "Report" tab and click it.

3. Leave all the search fields blank. If you would like a .csv file of the report, then check the box to "Download a csv file". Click the button at the bottom of the page to "Generate Report".

4. This takes you to a screen showing total counts of each kind of object in Islandora.

Info about columns in the Report:

  • The "serial" counts are counts of serial title records. "Serial component" counts are counts of all serial hierarchy tree "branches". "Serial PDF" are all article and issue-level PDFs associated with serial records.

  • The last column on the right provides total counts of all objects by collection.

  • The last row in the report provides total by Content Model for all collections listed.

  • The last cell in the bottom right of the report provides a total count of all objects.

  • NOTE: counts provided include counts of Islandora objects that have no content files of their own, e.g., book, serial, newspaper, compound objects, as well as counts of objects that have associated content files, e.g., basic image, large image, book page, PDF, thesis, video, audio, etc.  All objects are counted, whether they appear to be public or not. Objects subject to XACML policies are included in the counts.

Search fields:

When you run the report, you can limit results by: (1) date the object was uploaded to Islandora, or (2) search of a specific Solr field.

Date the object was uploaded to Islandora will allow you to show growth in a specific period of time. For example, you can show how much was uploaded in a specific fiscal year, or quarter.

Solr field search is not as immediately useful. If you would like to search by Solr field, contact for assistance.

  • Enter any search criteria such as dates objects were created. By typing "fgs.ownerid" and the name of an Islandora user in the "Optional - search Solr field" box you can limit the search to objects created by a specific user.

  • To obtain a complete count of all objects in your repository leave all fields blank.

  • To obtain a downloadable CSV file that can be opened and manipulated in Excel, check the "Download a csv file" box.

  • The click on GENERATE REPORT

Islandora Usage Stats

Islandora Usage Stats collects information on all views and downloads and stores the information directly in Islandora. Islandora Usage Stats has been turned on for all FL-Islandora sites starting on July 1, 2016 and added to all new sites that open to the public. Information collected by the module is NOT broken out by date. When you retrieve information or when Islandora displays it to the public, the views and download counts are cumulative and there is no way to scope by fiscal year or by other reporting period.

What is being collected

Islandora Usage Stats collects each view of the object, where a person browses to the web interface for the object, and each download of a file associated with that object. Islandora does not provide a download button for all objects. For example, the "Download" button is not available for Videos and so download counts will not be collected nor displayed for a Video object. When a download or a view is recorded, this information is added to information about the object. All that Islandora does is to add 1 to a view count or download count. There isn't any IP information nor any information about the date and time. Therefor, it is not possible to pull a report by fiscal year or to scope statistics.

Excluding IPs

You can exclude collection of statistics for hits and downloads from a list of IPs. This might be useful if you have a specific computer with a static IP which is used for digital library work. It is not possible to exclude a range of IP addresses. To request an IP be excluded, email . FLVC does not keep on file any history of IP exclusions, so if you implement an exclusion, we will not keep on file any record of when that exclusion is implemented or lifted.

Public display of Islandora Usage Stats

Statistics are displayed to the public on the "Full Description" tab in the top right corner of the object. For items where a "Download" button is available in Islandora, both "views" and "downloads" will display. For items where no "Download" button is available in Islandora, only "views" will display.

Logged in display of Islandora Usage Stats

When logged in to Islandora as Site Admin, Collection Manager, or Supervisor one can see a dashboard of statistics for items in that Collection. It only goes one level deep. So, if you have a Collection with Collections in it and then those child Collections hold items in them, then when you look at the dashboard for that top level Collection, you are only going to see the views for the immediate child Collections. You will not see views for all the items all the way down. This dashboard is set up to show 100 items at a time, then you have to click a pager to get the next 10 and so on. You can email to get a view of more items. There is no maximum limit to how many items per page can show on the dashboard.

Below is a screenshot of the statistics view for logged in users:


What is Altmetrics?

Altmetrics defined: “In scholarly and scientific publishing, altmetrics are non-traditional metrics proposed as an alternative to more traditional citation impact metrics, such as impact factor and h-index. The term altmetrics was proposed in 2010, as a generalization of article level metrics, and has its roots in the #altmetrics hashtag. Although altmetrics are often thought of as metrics about articles, they can be applied to people, journals, books, data sets, presentations, videos, source code repositories, web pages, etc.” - Wikipedia

Goal = Speed: Traditional metrics, like citations take years to accrue. Citation analysis is possible only after grant cycles have ended, tenure decisions have been made, and the state of research has moved on. Altmetrics includes uses and mentions that happen much sooner, and can predict long term value. Altmetrics is about scholarly research, not cultural heritage materials. Not applicable to everything in a digital library. Some kinds of altmetrics = viewed, discussed, saved, cited

NOTE: Altmetrics display is only available for the Citation content model and the PDF content model

The altmetrics display in Islandora depends on a DOI to show up. Almetrics is also more oriented around scholarly content and publications - altmetrics is a bit like citation analysis but with faster feedback. For these reasons, the display is only implemented in the Citation content model (a content model specific to institutional repository development) and in the PDF content model. These are most likely to hold scholarly publications which have a DOI issued.

FL Library Services is currently set-up to pull altmetrics from FL Library Services is pulling from the public free-of-charge API for While several vendors provide altmetrics (including Plum Analytics,, and ImpactStory), as of Fall 2017 there are no plans to implement any other altmetrics displays in Islandora.

What does the Altmetrics display look like in Islandora?

Here's an example: In the "Full Description" tab, the colored band from's free-of-charge API will show up under the download and view counts for the item. (FSU's site has social media icons, which is a custom display change just for the FSU site. These social media icons are not part of the altmetrics display, so you shouldn't see them on your site, unless social media icons is addressed by the ISG at some point in the future.)

How to Implement Altmetrics on your site?

The altmetrics display pulls from <identifier type="doi"> (or <identifier type="DOI"> ). This is in keeping with Library of Congress's user guide on MODS identifiers. See .

If the object has MODS with a DOI in the <identifier type="doi"> field and that DOI is formatted like 10.1038/srep16860 ( software won't recognize it when it's formatted like a URL), then Islandora will hit's free-of-charge API. If shows no use, then the colored band won't show up. If shows some use, then the colored band will show up.

Islandora Logs

FL Library Services  keeps server log files for the Islandora sites. As of Fall 2017, no analysis will be prepared on these logs. However, the information is available and in theory allows much more detailed reporting than the other methods of collection. For example, server logs show access to files, such as download of PDFs, which Google Analytics is not able to do. Server logs keep a date stamp on each activity, which the Islandora Usage Stats module does not do. Server logs also allow reporting of PALMM materials across the institutional site and the PALMM Islandora site, which is not available through any other method.

Google Analytics

Get Access to your Islandora site's analytics

FL Library Services pre-installs Google Analytics on all Islandora sites. If you already have a site, it has been collecting statistics since launch, and those statistics are ready for you to view and analyze. To access statistics for a site you must have a personal Google Analytics account. If you do not have a user account sign up here: Once you have a user account contact requesting access to Google Analytics for your site. Be sure to include the email address you use to log in to Google Analytics and the URL for your Islandora site.

Google Analytics Glossary:  Google Analytics has set terminology in how they measure web traffic. Please consult this glossary to better interpret your GA data:

Google Analytics Data Model:

Comparison of key terms:


  • An instance of a page being loaded (or reloaded) in a browser.

  • The amount of times visitors arrive on individual pages of your Website. If a user reloads a page, that action will be counted as an additional Pageview. If a visitor navigates to a different page and then returns to the original page, a second Pageview will be recorded as well. Pageviews allow you to see which pages on your site are the most popular

  • A Pageview represents an HTML or PHP page loaded in a Web browser window. Multiple views of the same Web page are counted in this metric.

    • What it's not counting: Google Analytics does not count access to files, like jpegs, PDFs, etc. This is because Google Analytics works by receiving a message from a bit of javascript in a site's template. That bit of javascript is not embedded in your PDFs and digital objects, so they do not send a signal back to Google Analytics. Google Analytics will count access to these files, only if the person accesses the file by clicking a link within the Islandora site. In that case, a bit of code around the incoming link will show that the link was clicked. This outgoing click to a PDF or jpeg is counted as an "Event", and can be viewed in Google Analytics under "Behavior" then "Events".

    • Pageviews measure traffic volume over time at the page-level, whereas Visits measure traffic at the Visit- or session-level. You can use Pageviews to measure aggregate traffic for groups of Web pages and subsites.

Session:  The period of time a user is active on your site or app. By default, if a user is inactive for 30 minutes or more, any future activity is attributed to a new session. Users that leave your site and return within 30 minutes are counted as part of the original session. See:

Hit:  A single-pixel image request that is used to send data to Google Analytics.

View:  A subset of a Google Analytics account property that can have its own unique configuration settings. You can create multiple views for a single property and modify what data shows in each view.

Overview of Custom Reports

FL Library Services has created custom reports to assist in filtering and interpreting your site’s traffic. After you have created a Google Analytics account, and gotten setup to view analytics for your site, you can click the link for one of these reports and install that report on top of your site's statistics. Installation instructions are further down the page.

NOTE: These templates are subject to revision as we learn how to better refine traffic data from Islandora. Templates indicate the most recent release date. In order to use the revised report, you will need to re-install the template after FLVC makes an update.

FL-Islandora Rpt 1: Object Pageviews:

June 30, 2016 and earlier report:

July 1, 2016 to present report:

A basic breakdown of all Islandora objects with pageviews and their pageview count.

FL-Islandora Rpt 2: Object pageviews - excluding collection objects:

June 30, 2016 and earlier report:

July 1, 2016 to present report:

This report displays a list of all Islandora objects and their pageview counts excluding collection objects and their pageview counts. This report is good for if you want a total of pageviews on unique items in your digital library without including pageviews for the unique collection objects.

FL-Islandora Rpt 3: Pageviews by collection:

June 30, 2016 and earlier report:

July 1, 2016 to present report:

This report aggregates pageviews by collection. The first level, Custom Variable (Value 01), identifies collection PIDs along with sum of pageviews of all children of each collection and the pageviews of the collection object. The second level breaks down each collection object. Selecting a collection object PID lists the PIDs of child objects within each collection including the PID of the collection object and the pageview count of each. The total pageviews presented in this second level should match the pageview count of the collection object selected in the previous level.

NOTE: If you are outside of the FL-Islandora system our custom reports may not be successful on your site as we made code changes to make these reports. A presentation about this code change and the Google Analytics is here:!.pdf.

FL-Islandora Rpt 4: Searches by collection:

June 30, 2016 and earlier report:

July 1, 2016 to present report:

This report counts queries made from within a collection. The first level identifies collection PIDs along with the sum of each search query that took place from within that collection object. The second level describes the query made and number of times it was made from this collection. This report does not describe the source of all traffic to your digital library items. Queries made from external sources such as search engines and catalogs are not included in this report.

FL-Islandora Rpt 5: Pageviews by content model:

June 30, 2016 and earlier report:

July 1, 2016 to present report:

List of content models and total pageview count for all objects using the corresponding content model. The second level breaks down objects in corresponding content model into a list of PIDs and each of the objects pageviews.

FL-Islandora Rpt 6: Pageviews by collection and by content model:

June 30, 2016 and earlier report:

July 1, 2016 to present report:

This report is a combination of the views by collection report and the content model report. The first level, Custom Variable (Value 01), identifies collection PIDs along with sum of pageviews of all children of each collection and the pageviews of the collection object. Selecting one of these collection PIDs will take you to the second level. The second level breaks down a collection by content models used by objects in that collection. Each row will contain a content model along with the sum of pageviews of all objects using that content model within the previously selected collection. Selecting a content model breaks down into a list of objects using this content model. The third level contains a list of PIDs using the content model and the pageview count for each of these objects.

Instructions for Installing a Custom Report

1) In the section above, click the link to the report you would like to install. That link with take you to your Google Analytics account showing the message "A Custom Report configuration was shared with you."


2) Select a view from the dropdown. You should have only one option for Islandora Production. If you track other websites with your GA account you may see these listed as well.


3) Once you've selected the view (ie. Islandora site), click "Create".


4) After creating the report you will be taken automatically to the report page.


5) Next time you log in to Google Analytics, here's how you get back to this page: From your home screen, browse to your Islandora site. Then look at tabs along the top of the screen, and click the tab labeled “Customization”. Then look at the “Custom Reports” links in the lefthand sidebar, and click the report you'd like to view.

Google Analytics Common Tasks

There are many online resources covering Google Analytics. You can run searches in Google to find instructions or answers to questions and tutorials on this software. Below are some basic tasks in the software to get you started.

Date Range: View statistics by date range

The default range of traffic for a report is set to the last 30 days of activity. To view an extended range of data navigate to the upper-right hand section of a report and select the dropdown arrow of the date range field. Use the calendar or the text fields to set the desired range you would like to view. Select apply and wait for the report to regenerate.


Search Terms: See what searches visitors run on your site

1) Log in to and browse to statistics for your Islandora site.

2) Along the left of the page, click the link for "Behavior".


3) Under "Behavior", click on "Site Search".

4) Under "Site Search", click on "Search Terms".


5) In the following page you will see a table of queries made within your Islandora site along with associated data. To learn more about a particular search term, such as the terms destination page, select the term from this list.

NOTE: This is measuring searches within your Islandora site. These are not limited to queries made from a search bar within Islandora. Searches are logged as any hit with ‘search’ as page path level two within the URI. This means that all of the following are also included in Search Terms: Sorting search results, selecting a facet from search results. removing a facet from search results, selecting ‘hotlinked’ metadata from object descriptions (subjects, names, etc.), browsing a bottom level collection as an anonymous user, paging through search results, and selecting the “View All Items” menu tab.

Locate Page Data

To see a list of all pages with traffic data on your Islandora site navigate to the Reporting tab and select Behavior from the left sidebar. From the list of options select "Site Content" -> "All Pages". This section features an interactive table of your site’s pages.

It’s important to note that this is not representative of the amount of “objects” in your Islandora repository -rather it is a rough measure of URL’s generated from within your Islandora site that Google has tracked. Without applying filters this data may not provide you much value.

To change the available items from paths to more readable Page Titles, locate the small menu above the table named "Primary Dimension". Change this option from "Page" to "Page Title". Please note that these Titles are not unique entries. All pages with matching titles are aggregated under each of these labels. For example, the Page Title “Edit datastream” represents the “edit datastream” page of every datastream that has been edited in Islandora. This may be thousands of unique “pages”.


To find a particular page or Islandora object you can use the search field found at the top right of the table. If you are searching for a PID or a query leave the Primary Dimension setting as “Page”. You cannot simultaneously search both URLs and Page Titles from this search field.


Content Drill Down

Your pageviews can be more easily broken down by type by using the Content Drilldown feature. Navigate to Behavior > Site Content > Content Drilldown. On this page you’ll see a list of paths in your Islandora site tracked by GA. They are broken down by “subdirectory” along the URL path. Selecting an item from this list will generate a list of “subdirectories” available of the item you have just clicked. You can drill down to the level of an object in Islandora by looking how the URL of that object is constructed. The object’s PID can be located in Content Drill down by navigating down through "Islandora" -> "object". All object “pages” in Islandora will be located within this level. Understanding the level hierarchy used by GA is vital to creating your own custom reports.

Export Data to Excel

Google Analytics allows the export of any viewable report into a number of formats. From the report toolbar select Export and choose the format for your exported report. The detail and layout of the exported report will depend on what report you are accessing.


NOTE: This feature will only export data from the rows you have set to be shown within the report in Analytics. To capture more rows of data navigate to the lower right hand corner of the report and increase the amount of rows to show. This is currently capped at 5000 in Analytics.

Track PDF downloads, outbound links, and email

Google Analytics defines certain user interactions with elements of a site as “Events”. This may be anything that is not tracked as a typical Pageview. To access this data navigate to the "Reporting" tab and select "Behavior" from the left sidebar. From the list of submenus select "Events" -> "Overview".

One the overview page you’ll see a list of Event Categories and a count of “events” that have taken place in each. Select "View Full Report" from this table or select "Top Events".

From the Top Events page you can select a category to drill down to see the event “action” to see more detail of the type of interaction a user had with the page. Select the action label to drill down and see a list of URLs that defined each of these hits. For example, if you want to see a list of PDFs downloaded from your site select "Behavior" -> "Events" -> "Top Events" -> "Downloads" -> "PDF".

Traffic Sources: See how people found your site

To find information on how users are getting to your site select the "Reporting" tab and locate "Acquisition" from the left sidebar. Expand the "All Traffic" submenu to reveal your traffic options.


Google Analytics automatically sorts traffic sources into common groups, or Channels. These breakdown as follows:

  • Direct/(none): Visitors enter a URL within your site directly into their browser

  • Organic: Traffic from search engines such as Google, Bing, etc.

  • Referrals: Visitors navigate to your site via a link on a 3rd party website. For example, a link on your library website.

  • Social: Visitors navigate to your site via a social networking platform such as Facebook, Twitter, etc. This is similar to referrals but ‘Social’ traffic comes from 3rd party sources GA recognizes as a Social networking site.

  • Email: Traffic originating from email.

There are additional channels such as those resulting from paid sources or advertising.

To see additional data on any of these channels click on them to drill down. "Direct" will provided a list of landing pages. "Organic Search" will provide a list of keywords search in search engines. To sort by search engine select "Source" as the Primary Dimension. Select "Landing Page" as "Primary Dimension" to see where on your Islandora site a user entered. "Referrals" will provide a list of websites linked to Islandora that visitors have used. Social will provide a list of social networks linked to Islandora that visitors have used.


This report will list an aggregation of all traffic broken down by source (typically the 2nd level dimension of the channels above) and the medium (one of the channels). In the example here the number one source of traffic is Google (source) searches -with traffic from searches being organic (medium). The number two source of traffic is listed as (direct)/(none), meaning the user typed the desired URL right into their browser -therefore providing no defining external source of the traffic. You can see lists of these dimensions sorted separately by selecting "Source" or "Medium" from Primary Dimension.


This report provides a more detailed list of referrals, including referrals from “Social” traffic. This list is helpful when you do not wish to separate your social networking traffic from your other 3rd party links, and if you’d like to see what traffic sources are linked to what objects. To see a list of objects each source is linked to just select an item from the list of sources.


Google Analytics provides a number of packaged reports on user data. These can be found by going to the Reporting tab and selecting Audience from the left sidebar. To see a quick breakdown of this information select "Overview".


To get a detailed list of the languages used by browsers that are accessing your Islandora site, expand the Geo submenu from within Audience and select Language. The list provided will not explicitly state the language, only a language code adapted from ISO 639 and 3166 standards.


The location report will detail the traffic of your Islandora site by country, city, continent, of origin, and so on. Select an item from the list to drill down sub-regional data. For example, selecting United States will break down traffic by state. Selecting state will allow you to drill down into city or metro region and so on. Each level will provide a geographic overlay of the data because Google is fancy.

Schedule E-Mail Reports

Any report in analytics has the option to be sent in an email. From within a report, simply navigate to the report toolbar and select the Email option.

A window will appear where you can configure the details of your report email.

The report can be emailed in any format available for export.

You may adjust the frequency of the email to daily, weekly, monthly, quarterly, or just once. Changing the frequency will generate additional options to refine the email schedule.

Select Advanced Options to select how the length of time you’d like the report email to be active. This can be scheduled up to a maximum of 12 months. This can be extended later.

You must provide text in the body of your email in order to be able to send it. The email will appear to be sent from the account you have registered in analytics.

Note: A report recipient has the option to opt-out of receiving future emails from analytics at any time.

If you’d like to include multiple reports in a regularly scheduled report you can do this by following the procedure above up until selection of the frequency. You’ll notice that after you’ve set up an email report a new option to "Add to an existing email" will appear in the lower right quadrant of the email report configuration window. Selecting this option will generate a list of your existing scheduled reports. Select the one you wish to add the additional report to and select "Save".

In order to cancel or create an extension for "Scheduled Emails" you must be able to access the "View" -> "Personal Tools & Assets" section of Google Analytics FL-Islandora Property. Select the "Admin" option from the header menu and locate "Scheduled Emails" in the "View" column.

This link will generate a searchable and sortable list of Scheduled Emails. You will be able to "Delete" and "Extend" the length of your emails from within this page.

Note: Selecting a report for extension will automatically extend its length by a year regardless of the original timeframe.


You can gain greater control over data comparison with the use of segments. Like reports, segments will allow you to sort and display your analytics data. Unlike reports, segments allow you to compare session or user data within reports and easily maintain these comparisons while moving between separate reports.

To add a new segment to a report you are viewing select "+ Add Segment" from the upper area of your report.

From here you can either add a preset Segment or create a custom segment. Custom segments can be shared much in the same way Reports can be shared. The custom Segment configuration provides more granular options for manipulating data which may not be valuable in analyzing Islandora statistics. Below you’ll find a simple custom segment to filter all session traffic referred from catalog sources. When designing a segment a live preview of the data will appear on the right.

Once you’ve added segments to a report you’ll be able to quickly compare data between your defined groups. Below is report of total pageviews with segments illustrating referrals from Google and library catalogs. The segments will be applied to each row of data in your report. 


Statistics and Altmetrics for Islandora Scholar

View and Download counts for content models

This is functionality which has now gone out to all Islandora sites, not just FLIIRT. Islandora collects some statistics through the software.


The Citation content model on test and production sites is set up to show an altmetrics display. The PDF content model on test sites only is set up to show an altmetrics display. (The display in PDF objects is ready for approval by ISG, and will likely be rolled out to production sites in Fall 2017.)

Here's an example: . In the "Full Description" tab, the colored band from's free-of-charge API will show up under the download and view counts for the item. (FSU's site has social media icons, which is a custom display change just for the FSU site. These social media icons are not part of the altmetrics display, so you shouldn't see them on your site, unless social media icons is addressed by the ISG at some point in the future.)

The altmetrics display pulls from <identifier type="doi"> (or <identifier type="DOI"> ). This is in keeping with Library of Congress's user guide on MODS identifiers. See .

If the object has MODS with a DOI in the <identifier type="doi"> field and that DOI is formatted like 10.1038/srep16860 ( software won't recognize it when it's formatted like a URL), then Islandora will hit's free-of-charge API. If shows no use, then the colored band won't show up. If shows some use, then the colored band will show up.