Art of the Blueprint

With Blueprints, you can add and organize data fields for any type of object or project, in the way that makes sense for you and your team, using your own terminology.

You know your objects, and you know what data you need to document. You shouldn’t have to skip over extraneous form fields or try to make objects “fit” into predefined categories. And best of all, Blueprints are flexible and simple to update, whether you're adding, renaming, or deleting fields.

What are Blueprints?

Blueprints are data structures for the objects in your Base. You can create and customize Blueprints for:

  • Types of objects
  • Projects with objects
  • Groups of objects

When you set up a Blueprint, you’re setting up custom form fields for your object information.

The Core Blueprint

The first step in organizing your Blueprints is to create the Core Blueprint.

Your Core Blueprint serves two important functions:

  • It is the default Blueprint selection for any object added to your Base.
  • It is the foundation upon which all your other Blueprints will be built.

Ask yourself: What information will I document for every object?

If all your objects have an accession number and a description, you can add these fields to your Core Blueprint (see Adding Fields below). Once added to the Core, these two fields will be included in any other Blueprint you create.

The Core can be as simple or as detailed as you like, with one field or thirty. At minimum, it will always include a title field.

Sample Core Blueprint

Adding Fields

Let’s add fields to the Core Blueprint.

There are two ways to add fields. Below the Fields tab, you’ll see Types and Presets.

Adding a field using Types and Presets

Under Types, you’ll see all the available field types.

Click the + icon to add a field to your Blueprint.

Adding a Short Text Field

Double click the new field to customize it.

  1. Add a label (the name of your field).
  2. You have the option to change the field type.
  3. Toggle on whether data is required and/or if the data to be entered in this field is internal (more on this below).
  4. Add data entry notes for users.
  5. Remember to save.

Customizing a Short Text Field

Under Presets, you’ll see readymade field options.

Click the + icon to add a preset field to your Blueprint.

Presets include: Artist, Creator, Credit Line, Date, Description, Dimensions, Location, Maker, and Medium.

You can still customize and update preset fields. Let's add a Description field, which is a Long Text field type.

Adding a Preset Field

Double click the new field to customize it.

  1. Once you use a Preset field type, it will be greyed out in the list.
  2. For the Long Text field type, you'll have the option to enable Markdown. Markdown allows you to add special formatting (for example, italics on a title) when you enter object information in the field.
  3. Here the "Internal Only" field is toggled on. Any data entered in this field will not be displayable in Modules.

Customizing a Preset Field

Selecting Field Types

When you add a field, you’ll select a preferred field type (you can update these anytime). These field types determine the type of information you’ll enter when you input data for your objects.

  • Short Text: ideal for a single line of information like an accession number
  • Long Text: ideal for multiple lines of text like an object description, with the option to allow the use of Markdown for special formatting (for example, for italicizing titles)
  • Select: allows you to enter a list of selectable options like mat colors
  • File Select: allows you to select a file name from an object’s available files
  • DataSet: allows you to choose from a list of selectable options; DataSets can be used across any Blueprint in your Base (read more in Using DataSets)
  • Switch: allows you to create a toggle switch
  • Date: allows for the entry of a month, date, and year (for example, 05/25/2025)
  • Tags: ideal for adding searchable keywords for your objects
  • Number: for whole numbers
  • Section Heading: headings for organizing your fields (for example, “Display Plans” or “Bibliography and Resources”); you can toggle on the option to collapse the fields within a section
  • Spacer: adds an empty space
  • Placeholder: reserves space when you’re not yet sure of the field type or information to be entered

Adding Blueprints

Once you’ve set up the Core Blueprint, you can create Blueprints for specific types of objects, projects with objects, or groups of objects. You can add as many as you like.

Remember, every new Blueprint you create will already contain the fields from your Core Blueprint.

Blueprints List

Add a Blueprint by clicking the + icon, giving it a name, and selecting the category (Object for a type of object, Project for a project with objects, or Group for a group of objects).

Add a Blueprint

Under the Settings Tab, you can add a helpful description of your Blueprint.

Blueprint Description

Structuring Blueprints

For each of your Blueprints, you can add and customize the fields for your objects and projects, and it’s simple to update them as your informational needs evolve.

  • For a Prints Blueprint, you might add fields for Printmaker and State.

  • For a Photographs Blueprint, you might add fields for Photographer and Negative Date.

  • For a Portraiture Exhibition Blueprint, you might add a fields for Object Label Text and Mat and Frame Information.

Arranging Rows and Fields

  1. Under the Fields tab, add new fields. These will appear at the bottom of the Blueprint.
  2. You can move rows by dragging the tab at right.
  3. You can delete a row by clicking the “X” to the left of the row.
  4. You can arrange fields by dragging and dropping (you can have up to three fields in a single row, but you can’t mix a Core field and a non-Core field in a single row).
  5. You can edit or delete a single field by clicking the “…” icon.
  6. Core fields display a padlock – you can only update and delete these in your Core Blueprint.
  7. Remember to save.

Structuring Your Blueprints

Blueprint Options

If you’d like to upload information for a group of new objects for a particular Blueprint, you can do this using a CSV. Select Download CSV Template. The column headings in the CSV will correspond to the fields in your Blueprint. Read more in CSV Guidelines.

If you’d like a record of your Blueprint field structure, you can download as JSON.

When there are no objects using a Blueprint ("0 Objects use this Blueprint"), you can delete it.

Blueprint options

Your Blueprints in Action

When you add an object, you’ll select a Primary Blueprint. You can also associate your object with additional Blueprints (if they’re included in a project or group).

For this painted portrait:

  1. We’re viewing the fields for the Paintings Blueprint. This is indicated by the Blueprint name below the object's title and the highlighted selection in the dropdown menu.
  2. Paintings is the primary Blueprint – indicated by the star.
  3. Portraiture Exhibition is an associated Blueprint – indicated by the check.

Blueprint Dropdown

Locking a Blueprint Field

After you enter object information in a field (for example, an accession number or dimensions) you can go back to your Blueprint and toggle on the option to lock that field.

Locking a Blueprint Field

Locked fields will display a padlock.

No data can be entered or updated in a locked field unless that field is unlocked in the Blueprint.

Object with Locked Fields

Filtering Objects by Blueprint

From your objects page, you can filter by Blueprint.

Filter by Blueprint


Blueprints empower you and your team to structure and prioritize data that matters for your objects and your projects. That’s pretty exciting!

Want to discuss Blueprint strategies and goals with us? Do you have questions about setting up your Blueprints? Get in touch!