How to Manage Folders

What You’ll Learn

In this section, you will learn:

  • What a folder is
  • How to manage folders manually
  • How to manage folders in bulk

What is a Folder?

A folder is a way to organize your entities, just like in a filing cabinet. You can folder your entity so that you know how to easily find it again in the future – not just in the Knowledge Graph, but throughout the platform. Most advanced filters will allow you to filter by folder outside of the Knowledge Graph.

Best Practices for Organizing Folders

How you organize your folders is completely up to you! Many customers choose to organize by features like geography, brand, entity type, franchise group or key differentiating properties of the entity (e.g., Dine-in vs. Takeout Restaurants).

One of the main factors for deciding folder structure is often determined by user access. If you want users to be able to access a group of entities, the best way to manage this is via folders, otherwise you’ll have to list out permissions on each entity individually which can become cumbersome to manage. We recommend determining your user requirements before or in tandem with determining your folder structure. But, don’t worry too much – you can easily update and change both!

Keep in mind:

  • Entities can only be in one folder.

  • A good folder structure has multiple entities in each folder. You want to avoid folder structures where each entity is in its own folder, this indicates you have not picked the best way to organize your entities.

  • You can have 5 levels of folders, e.g., folder levels example

Whatever you decide, there are 3 ways that you can manage your folders:

  1. Manually
  2. In bulk
  3. Via API (cannot create new folders, only move entities to folders)

Managing Folders Manually

To add a folder manually, you can simply click from the left-side bar in the folder section. If it’s your first folder, you can click +Add a Folder. If you already have at least one folder, you can click the “…” and select “Add a Folder”. You want to make sure you do this on whatever folder should be the parent folder. In the example below for Add Additional Folder, this would create a folder withins the California folder.

add new folder manually options

To move an entity into a folder, you can:

  • Click and drag an entity or a selection of entities from the table into a folder
  • Update the folder field in Entity Edit (Internal Use Only > Folder)

Managing folders manually is fine if you only have a few or you need to make a few adjustments. Otherwise, we recommend managing folders in bulk.

Managing Folders in Bulk

Once you’ve settled on a folder organization strategy, you’ll be able to manage your folders in bulk. With this tool, you specify which field(s) you want to use to organize the folders and click apply. The system will save your preferences so you can easily re-folder your entities in the future.

Within the tool, you have 2 options:

  • Universal Folder Structure: Use this if you want one global structure, regardless of types.

  • Entity Type Specific Folder Structure: This allows you to set up separate organization structures by entity types. For example, you could organize Locations by Country > Region and Jobs by Department at the same time. These per-entity structures use different fields and depths of folders.

Here’s how it works:

  1. To access the tool, navigate to Account Settings > Manage Folders.

  2. If it’s your first time setting up your Folder Structure, you’ll need to click to Setup Initial Structure.

  3. Choose whether you want to organize via Universal Structure or Entity Type Specific Structure.

  4. Click Save.

  5. Click into the Structure field to start mapping which fields to use to folder your entities. You can add up to 5 sub-levels.

  6. We recommend previewing your changes.

  7. Click Save if you just want to Save the structure, but don’t want to apply it yet. Click Save and Reorganize to both save the structure and reorganize the entities in your account to follow that structure.

  8. The system will create any necessary folders, delete any folders that are no longer in use, and move entities around.

Note: Since this could impact user permissions, we strongly encourage you to do this with care. Deleting folders will delete any Access Permissions users had for those folders. It can be difficult to fix this so if you’re not sure, reach out to Support for assistance.

Note - this video shows a bug where the entities are not actually foldered. This is being fixed, video is a placeholder to see the rest of the flow.

light bulb
You can also move entities to a folder in bulk using the Entity Upload tool. You can choose which locations (all, new only, missing only, updated only) are moved to a folder in the Configure File step.

light bulb
If you only want to folder a subset of entities in bulk, you can do so by going to Entity Search, filtering to the entities you want to folder, clicking More Actions > Folder Entities. Common use cases for this is if you’ve just added a set of new entities and want to put them in the proper folders or if you have some entities that don’t follow the full foldering structure.
unit Quiz
+20 points
    Error Success Question 1 of 3

    If you have one level of folders, how many additional levels can you nest as sub-folders?

    Error Success Question 2 of 3

    True or False: Changing folder structure in bulk can be a risky operation?

    Error Success Question 3 of 3

    If you want to have different ways of structuring folders for each entity type, what should you select?

    A Hitchhiker in the making! 🔥

    You've already completed this quiz, so you can't earn more points.You completed this quiz in 1 attempt and earned 0 points! Feel free to review your answers and move on when you're ready.
1st attempt
0 incorrect