Still have questions about Virginia Heritage? Explore our FAQs, EAD (Encoded Archival Description) best-practices tutorials, and membership information below to help you get started.
Virginia Heritage finding aids are created using Encoded Archival Description or EAD. We are currently using Version 2002. There are multiple ways to create an EAD finding aid.
- You can create one manually.
- You can use the clip library, maintained by Virginia Heritage in GitHub and NoteTab text editor.
- You can use the DACS-compliant form (you fill in the mandatory and any optional fields you choose, and we will return an XML file to you).
- ArchivesSpace users can have their finding aids automatically harvested. Contact Kira Dietz if you want to get set up!
- Go to the Administrative site and click on "Admin Upload."
- It will prompt you to enter your institution's username and password
- Click on “choose file”
- Locate the file (you can only upload one file at a time!)
- Click “upload”
- The default schema type that is listed. You should not change the schema type unless you are working with EAD3.
- The system will attempt to validate your file.
- If you get a green box with a link to your finding aid, you’re all set!
- If you get a yellow box with a message and a link to your finding aid, there are things you may want to change in your code, but the file is considered valid.
- If you get a red box, there will be an error message (or messages) and no link. If you can’t figure out how to fix the file or don’t understand the message, please copy the message or take a screenshot and contact the chair of the Technology Team, Kira Dietz. Or you can post your question to the VIVA SC list (email@example.com) or to the Virginia Heritage Slack Channel.
If your finding aids are harvested from ArchivesSpace then they will be added automatically.
- You can override a file in the database by uploading a new version with the same identifier (MARC code + number, exs. viblbv01986 or vi00399)
- Updated files can immediately be accessed using the link directly, but this system re-indexes at night, so any new changes will not be found in a database search until the following day.
- If your finding aids are harvested from ArchivesSpace changes will appear the following day after the system re-indexes.
- At this time, you cannot delete a file yourself. If you need something permanently removed, please provide the identifier(s) for anything you need to be deleted to Steve Majewski. He can remove them.
- Updated files will disappear from the database when they are removed, but the system reindexes at night so that they may appear in search results for up to 24 hours.
Log in to the administrative site and click on "published directory" on the ribbon menu.
Files are also available on the GitHub site:
- Enter this address https://github.com/VAheritage/allEADs/tree/svn/[your org name], for example for the Library of Virginia enter: https://github.com/VAheritage/allEADs/tree/svn/lva
- To view an individual guide, add the file name to the end of the url: e.g. https://github.com/VAheritage/allEADs/blob/svn/lva/vi01114.xml
Virginia Heritage has a dashboard feature that displays:
- Number of unique visitors
- Number of returning visitors
- Time spent on site
- Most common referrers
- Most popular finding aids
The statistics are shown by day, month, year, or a specific date range. View the dashboard for your organization by logging into the administrative site and click "dashboard" on the ribbon menu.
Please note that the dashboard can be slow to update when you change the parameters. Contact Kira Dietz if you have any questions or issues.
Finding aids created using the clip library have a logo and address files containing an institution's information. Rather than adding that information every time a finding aid is created, the information is stored, and a URL points to the information. To change that information, contact Steve Majewski.
If similar information is in your Institutional Profile, please contact firstname.lastname@example.org so that the Outreach Team can update your information.
- Administrative site - use this site to:
- Upload, download, and validate an EAD file to Virginia Heritage (password required)
- Access the statistics dashboard
- Access the public directory
- Virginia Heritage best practice guidelines
- DACS-compliant form for EAD creation
- This form can be used to input basic information about a collection to receive an EAD file for upload to Virginia Heritage. Contact Kira Dietz if you have questions or issues.
Virginia Heritage Sessions
As an added benefit for our members, VH is now hosting regular sessions to address topics of interest. These range from open sessions to communicate with members about VH and to answer questions and received feedback, to presentations on tools and workflows for creating finding aids. The standing time for the sessions is the first Thursday of the month at 11 am. Some of the sessions are recorded and you can access them here.
Encoded Archival Description (EAD) Tutorials
This series of four screencasts instruct users on creating EAD finding aids using NoteTab Light and the clip library. Questions? Contact email@example.com.
Interested in joining?
- How can my organization become a contributor to Virginia Heritage?
- See the Join Virginia Heritage webpage!
- What is my organization’s MARC code?
- What’s my organization’s username and password?
- If you don’t have your organization’s username and password to upload finding aids, contact Steve Majewski. He can help you get or reset your password.
Membership is free to libraries, museums, colleges, universities, and other cultural institutions that have archival holdings they wish to share.