--- title: "What is a directory in Linkbreakers" description: "Learn what a directory is in Linkbreakers, how directories organize QR codes and links, and which plans include directory access." canonical: "https://linkbreakers.com/help/article/what-is-a-directory-in-linkbreakers" last-updated: 2026-10-30 --- # What is a directory in Linkbreakers > Learn what a directory is in Linkbreakers, how directories organize QR codes and links, and which plans include directory access. ## Short answer A directory in Linkbreakers is a folder-like way to organize your QR codes and links inside a workspace. Directories help you group related QR codes, keep large workspaces clean, and make it easier to find, manage, and bulk-create links without leaving everything at the root level. Directories are available on the Pro plan and Enterprise. They are not included on the Free or Light plans. ## Why directories matter As soon as a workspace contains more than a handful of QR codes, flat lists become harder to manage. Teams usually need a cleaner structure for campaigns, clients, regions, products, events, or sales materials. Directories solve that by giving you a hierarchy. Instead of keeping every QR code in one long list, you can place related items into directories and subdirectories. Common examples include: - `Marketing` - `Marketing / Trade Shows` - `Sales / Product Sheets` - `Restaurants / Paris / Window Posters` ## What you can do with directories Directories in Linkbreakers are designed for practical workspace organization. You can: - Group QR codes by campaign, team, location, or customer - Create nested subdirectories for more precise structure - Select a directory during QR code creation - Assign directories during bulk insert imports - Filter workspace analytics to one directory and everything below it - Keep reporting and day-to-day management easier for large workspaces This is especially useful when multiple people work in the same workspace and need a shared structure that stays consistent over time. ## Directory examples A few simple directory strategies work well for most teams: ### Campaign-based structure Use directories when you run recurring campaigns and want every QR code stored in the right place. Example: - `Marketing / Spring Launch` - `Marketing / Summer Promo` - `Marketing / Trade Shows` ### Location-based structure Use directories when the same business runs QR codes in multiple stores, offices, or markets. Example: - `Retail / Paris` - `Retail / London` - `Retail / New York` ### Client-based structure Agencies and consultants often prefer one directory tree per client. Example: - `Clients / Acme` - `Clients / Northwind` - `Clients / Globex` ## Analytics by directory On a workspace analytics dashboard (**Insights**) and on **Live**, click **Filter**, choose **Links**, then the **Directory** tab. Pick a directory and every widget narrows to the links in that directory and in every directory below it, so picking `Clients / Acme` also covers `Clients / Acme / Spring Launch`. - The **Links** filter takes one directory, one [tag](/help/article/how-to-use-tags-to-segment-and-analyze-qr-campaigns) or one link at a time; picking one replaces the other - Add a **Country** filter on top to read a directory country by country - The filters are kept in the page URL (`?directory=`), so you can bookmark the filtered view or share it with teammates - The Assistant in **Edit & Analyze** answers with the same filters the widgets show - A link's own dashboard offers only **Country**, since it is already scoped to one link The filter is a view, not a permission: every member of the workspace still sees the whole workspace. For developers, the analytics endpoints, the MCP analytics tools and the SDKs accept an optional `directory_id` (`directoryId` in REST JSON) next to `link_id`. An empty directory returns nothing, never the whole workspace. The events list accepts `directory_id` too. Send at most one of `link_id`, `directory_id` and `tag_id`: sending more answers `400 LINK_FILTER_LINK_AND_DIRECTORY`, and a directory outside the workspace answers `404 DIRECTORY_NOT_FOUND`. Agencies often keep one workspace with a directory per client and read each client's numbers this way. To keep clients fully separate instead, each with its own plan and billing, [create a workspace per client](/help/article/work-across-multiple-workspaces). [How to keep QR codes and analytics separate for multiple clients](/help/article/how-to-manage-qr-codes-for-multiple-clients) compares the two setups step by step. ## Directories and bulk insert If you use bulk insert, directories make imports easier because each QR code can be assigned directly to the right place during CSV upload. For example, a CSV directory value such as `Marketing / Trade Shows` can point the QR code to that directory path instead of dropping everything into the root workspace. This makes bulk QR code creation much more manageable for teams importing campaign batches, event assets, or large product catalogs. ## Who should use directories Directories are most useful if you: - Manage many QR codes at once - Run multiple campaigns in parallel - Work with teammates in a shared workspace - Need cleaner structure for clients, regions, or product lines - Want to read analytics for one client, region, or campaign at a time - Use bulk insert and want imported QR codes filed correctly If you only create a small number of QR codes, a flat list may be enough. Once volume grows, directories usually become necessary. ## Plan availability Directories are included with: - Pro - Enterprise Directories are not included with: - Free - Light ## Final takeaway A directory in Linkbreakers is the simplest way to keep QR codes and links organized as your workspace grows. If you manage campaigns at scale, work with teammates, or import links in bulk, directories help you keep everything structured and easier to operate.