CSV Import

By Omeka Team and Daniel Berthereau Import and update content (items, item sets, media, users) from a CSV, a TSV or an ODS file.
Download 2.6.1

CSV Import (module for Omeka S)

CSV Import is a module for Omeka S and will allow users to import Entities from a simple CSV (comma separated value) file, and then map the CSV column data to Entity. Each row in the file represents metadata for a single Entity.

Furthermore, it’s possible to import directly files in formats TSV (tab separated value), a simpler and more efficient format, and ODS (OpenDocument Spreadsheet, the ISO standard office format for spreadsheets, managed by LibreOffice and a lot of other tools) directly.

Most often, the import will create new Omeka S items. It is also possible to import item sets, media and users, and other modules can add other import types. It’s possible to import mixed resources in one file too.

See the Omeka S user manual for user documentation.

Installation

See general end user documentation for Installing a module.

To install CSV Import from the source, go to the root of the module, and run composer install. Users using the pre-packaged downloads from the Releases page or the omeka.org module directory don't need to worry about this step.

To be able to import ods, the php extensions zip and xml should be installed (default in most cases).

Warning

Use it at your own risk.

It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.

Troubleshooting

See online issues on the Omeka forum and the module issues page on GitHub.

License

The Corporation for Digital Scholarship distributes the Omeka source code under the GNU General Public License, version 3 (GPLv3). The full text of this license is given in the license file.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Contact

Current maintainers:

  • Omeka Team
  • Daniel Berthereau (see Daniel-KM on GitHub)

Copyright

  • CSVImport is Copyright © 2015-present Corporation for Digital Scholarship, Vienna, Virginia, USA http://digitalscholar.org

The Omeka name is a registered trademark of the Corporation for Digital Scholarship.

Third-party copyright in this distribution is noted where applicable.

All rights not expressly granted are reserved.

  • Copyright Daniel Berthereau, 2017-2019
Version Released Minimum Omeka version
2.6.1February 03, 2024 [info]^4.0.0
2.6.0January 25, 2024 [info]^4.0.0
2.5.1December 22, 2023 [info]^4.0.0
2.5.0August 07, 2023 [info]^4.0.0
2.4.1January 19, 2023 [info]^4.0.0
2.3.2October 08, 2022 [info]^3.0.0
2.3.1April 06, 2022 [info]^3.0.0
2.3.0February 17, 2022 [info]^3.0.0
2.2.1December 02, 2020 [info]^3.0.0
2.2.0October 08, 2020 [info]^3.0.0
2.1.2August 27, 2020 [info]^2.0.0
2.1.1December 10, 2019 [info]^2.0.0
2.1.0August 08, 2019 [info]^2.0.0
2.0.0January 24, 2019 [info]^1.0.0
1.1.0November 08, 2017 [info]^1.0.0