Tainacan

PMF

How do I get started?

After installation, click on the “Tainacan” menu item in your WordPress admin panel. You can create your first collection by clicking “New Collection”, configure its metadata and filters, and start adding items to your collection.

For an overview of the main concepts, visit our documentation.

Can I use Tainacan with any WordPress theme?

Yes! Tainacan works with any WordPress theme, but developers can improve their integration. If you want more dedicated page templates we recommend using the Tainacan Interface theme, which is our classic theme that meets the demands of most collections. But you can also try using an FSE theme such as Tainá, or install an integration plugin for a popular theme such as Blocksy.

How do I browse my collections on the public side?

Visit https://your-site/collections to see the list of your collections. You can also add links to the collections in your menu by editing it and enabling “Collections” in the Screen options.

Can I import data from other systems?

Yes! Tainacan supports importing bulk data from CSV spreadsheets. You can also use bulk editing tools to perform adaptations from your system modeling to the one you created in Tainacan.

Does Tainacan have an API?

Yes! Tainacan implements a complete RESTful API (read and write) that allows other applications to interact with your repository. You can expose your collection in different formats such as JSON, CSV, and HTML.

What metadata standards are supported?

Tainacan allows you to define your own metadata standards by adopting a variety of types (text, relationship, numeric, date, geocoordinate etc.), but also supports predefined ones including Dublin Core and INBCM. Even when creating your own, you can still define mappers to other standards, allowing you to export to other systems.

What are taxonomies and how do I use them?

Taxonomies in Tainacan are vocabularies that can be used across all your collections. You can configure taxonomy metadata with a set of hierarchical terms of your own vocabulary. This allows you to create controlled vocabularies that can be reused throughout your repository, ensuring consistency across different collections.

How do I use Gutenberg blocks with Tainacan?

Tainacan offers several Gutenberg blocks so you can present your collections in many different ways! You can display items, collections, search interfaces, and more. Simply add the blocks to your posts and pages through the WordPress block editor.

Where do I report security bugs found in this plugin?

We take security very seriously. Please report any security bugs found in the source code of the Tainacan plugin through the Patchstack Vulnerability Disclosure Program. The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.

I’m getting 404 errors or blank pages when accessing my collection

After site migration, plugin updates, or new installations, you may need to rebuild WordPress permalinks. If collections or pages are returning 404 errors despite already having items on it, go to Settings -> Permalinks in your WordPress admin panel, ensure “Post Name” or a Custom Structure with /%postname%/ is selected, then click Save Changes (even if nothing changed). This will rebuild the permalink structure.