Documentation
  • Tropy Basics
  • What's New
  • Before you begin
    • Tropy Basics
    • Who owns the rights to the archival materials I use?
    • What is metadata and how do I use it?
  • Using Tropy
    • Intro to the interface
    • Create a new project.
    • Add photos to Tropy.
  • In the project view
    • View photos in project view.
    • Combine photos into items.
    • Add metadata to items.
    • Tag items.
    • Organize items into lists.
    • Search for items, metadata, notes, or tags.
    • Copy and paste items.
    • Delete items.
  • In the item view
    • Getting started in the item view
    • Edit photos in an item.
    • Create selections within an item.
    • Take notes on or transcribe the content of an item.
  • In the template editor
    • Getting started with templates
    • Create a new template.
    • Edit a template.
    • Export and import templates.
    • Add vocabularies.
  • Other features
    • Export from Tropy
    • Export with CSV Export plugin
    • Export with Archive plugin
    • Export to Omeka S
    • Print items
    • Keyboard shortcuts in Tropy
    • Preferences
    • Collaboration
  • Troubleshooting
    • Moving photos
    • Reporting problems
    • Backup
Powered by GitBook
On this page

Was this helpful?

  1. Other features

Export with CSV Export plugin

PreviousExport from TropyNextExport with Archive plugin

Last updated 2 years ago

Was this helpful?

Using the CSV Plugin

1. Download and install the plugin.

Download the plugin zip file from the . Then, in Tropy, navigate to Preferences > Plugins (in Windows, Edit > Preferences > Plugins).

Click on Install Plugin. In the dialogue box that opens, navigate to wherever you saved the plugin folder from GitHub; select it, then click Open. You have now installed the CSV Export plugin.

2. Activate and customize the plugin.

First, click Enable next to the plugin's name.

Then click on the name of the plugin to open up a customization panel within the Plugins pane.

You will see there several options for customization. You can change the name of your plugin instance if you wish. Then check the boxes for the options you want.

The fields labeled Item Template and Photo Template tell Tropy exactly which fields you want to include in the CSV export. If you are exporting items that use a custom template for items or photos, you should select that template in the appropriate Template field here. That ensures that all the fields are exported and in the order you expect.

You can also set the default file name of the export (though this can be changed when you're using the plugin), or choose to copy the exported data to your clipboard instead.

3. Use the plugin to export items.

Once you have customized the plugin, close the Preferences window (there's no Save button---your settings autosave).

In your item table, right-click on the item you wish to export, or select multiple items and then right-click. Navigate to Export Selected Items and click on the name of the CSV Export plugin (remember that you might have given it a different name in the Plugins customization window).

A dialog box will open. Select where you want to save your exported CSV and change the name of the file if you wish. Then click Save.

4. Look at your CSV in another application.

Your CSV should be complete! If you look at the CSV in another application, you'll notice that the header row is the URIs of the fields in your chosen metadata template. Tropy exports using the URIs because it's possible that you have multiple labels for the same property across various templates.

Notes

If you anticipate exporting items in specific different categories often (e.g., newspapers and correspondence), you may wish to have two separate instances of the plugin so you don't have to switch back and forth between your Newspaper template and your Correspondence template in the Plugin settings. To add another instance, click on the plus sign next to the first plugin instance to add another instance and customize it as you wish (without deleting the first instance). Be sure you name it something different!

If you're exporting multiple items that use multiple templates for items or photos, you'll want to create a new template in the that includes all the fields you want in your export. Then select that template in the Item Template or Photo Template field here in Plugins.

For more details about the various customization options, see the

template editor
plugin README
latest release in GitHub
CSV Export customization window
Using the CSV plugin in the item table
Multiple CSV plugin instances