Directoryz
The Directoryz field guide

Build a directory people can rely on.

Practical operating guides for directory publishers: organize listings, prepare data, review submissions, and build useful discovery experiences.

104 practical guides8 topics
Listing data

Choose required fields for a directory listing

Required fields should support the visitor's first decision.

Read the guide ↗
Listing data

Write unambiguous listing field definitions

A field name alone may not tell contributors what belongs in it.

Read the guide ↗
Listing data

Represent unknown listing information clearly

Unknown, not applicable, and unavailable are different states.

Read the guide ↗
Listing data

Write listing descriptions that add useful context

A description should explain what the listing offers and who can use it.

Read the guide ↗
Listing data

Track where listing facts came from

Source provenance makes future correction possible.

Read the guide ↗
Listing data

Use a meaningful last-reviewed date

A review date should indicate that someone checked the listing, not merely that a file was rebuilt.

Read the guide ↗
Listing data

Choose a clear contact route for listings

Visitors need to know what happens when they contact a provider.

Read the guide ↗
Listing data

Choose informative listing images

An image should identify the listing or show something relevant to the decision.

Read the guide ↗
Listing data

Model directory price information without false precision

Pricing often depends on scope, plan, or usage.

Read the guide ↗
Listing data

Separate service areas from office locations

A provider can serve places where it has no office.

Read the guide ↗
Listing data

Give each listing a stable identity

A listing needs a stable identifier even when its name or website changes.

Read the guide ↗
Listing data

Define listing status labels people understand

Status labels should describe a real editorial or operational state.

Read the guide ↗
Listing data

Create a model listing for contributors

A completed example can teach contributors more than a long form instruction.

Read the guide ↗
Imports and cleanup

Map CSV headers to directory fields

Header mapping should connect meanings, not just similar names.

Read the guide ↗
Imports and cleanup

Diagnose garbled characters in a CSV import

Garbled names can result from an encoding mismatch before the directory sees the data.

Read the guide ↗
Imports and cleanup

Check CSV delimiters before importing

A file may use commas, semicolons, or another separator despite its extension.

Read the guide ↗
Imports and cleanup

Remove empty and explanatory rows from import files

Spreadsheet exports can include blank rows, notes, or repeated headings.

Read the guide ↗
Imports and cleanup

Normalize listing website URLs carefully

Equivalent website URLs can appear in several forms, but aggressive normalization can erase meaningful paths.

Read the guide ↗
Imports and cleanup

Find duplicate records before importing

Duplicate detection needs more than a matching name.

Read the guide ↗
Imports and cleanup

Resolve conflicting values when merging listings

A merge should preserve the best-supported value, not simply the newest row.

Read the guide ↗
Imports and cleanup

Choose a representative import sample

A sample should exercise the difficult cases in the dataset.

Read the guide ↗
Imports and cleanup

Prepare a rollback plan before a bulk update

A bulk update is easier to recover from when the previous values and affected records are known.

Read the guide ↗
Imports and cleanup

Check spreadsheet formulas before exporting directory data

CSV files contain exported values rather than the live logic of a workbook.

Read the guide ↗
Imports and cleanup

Prepare multi-value listing fields for import

Categories and tags need an agreed representation in the source file.

Read the guide ↗
Imports and cleanup

Keep a useful bulk import audit log

An audit log should identify what changed and how to investigate it.

Read the guide ↗
Imports and cleanup

Review a directory after a bulk import

A successful import message confirms processing, not editorial correctness.

Read the guide ↗
Categories and filters

Define clear boundaries between directory categories

Categories become difficult to maintain when their meanings overlap without a rule.

Read the guide ↗
Categories and filters

Decide whether a label should be a category or tag

Categories usually organize the main browsing structure, while tags can describe cross-cutting attributes.

Read the guide ↗
Categories and filters

Prioritize the filters visitors actually need

A long filter panel can make a directory feel complex before it becomes useful.

Read the guide ↗
Categories and filters

Design helpful empty filter results

An empty result should explain how to recover.

Read the guide ↗
Categories and filters

Choose category names people can recognize

Internal department language may not match the terms visitors use.

Read the guide ↗
Categories and filters

Write category introductions with a useful purpose

A category introduction should explain scope or selection criteria.

Read the guide ↗
Categories and filters

Measure category coverage before expanding

A directory can appear broad while leaving important categories nearly empty.

Read the guide ↗
Categories and filters

Merge overlapping categories without losing clarity

Merging categories should simplify navigation while preserving meaningful distinctions.

Read the guide ↗
Categories and filters

Split a broad category using observable criteria

A split works when editors can apply the new distinction reliably.

Read the guide ↗
Categories and filters

Design a location hierarchy for directory browsing

Location browsing should reflect the geographic decisions visitors make.

Read the guide ↗
Categories and filters

Add alphabetical browsing when names are known

Alphabetical browsing helps visitors who already know a name.

Read the guide ↗
Categories and filters

Check data coverage before exposing a filter

A filter can silently exclude good listings when the underlying field is mostly missing.

Read the guide ↗
Categories and filters

Document taxonomy changes for editors

Category changes affect imports, submissions, links, and reporting.

Read the guide ↗
Submissions and review

Write submission instructions that reduce rework

Contributors need to know what qualifies before they start a form.

Read the guide ↗
Submissions and review

Ask for useful evidence in listing submissions

Evidence requests should support the facts you publish.

Read the guide ↗
Submissions and review

Prioritize a directory submission review queue

A review queue needs a repeatable order so difficult items do not disappear.

Read the guide ↗
Submissions and review

Request listing corrections clearly

A correction request should tell the contributor what is missing and why it matters.

Read the guide ↗
Submissions and review

Explain a rejected directory submission

A rejection should refer to the directory's stated scope or requirements.

Read the guide ↗
Submissions and review

Review a revised listing without restarting everything

A revised submission should preserve the earlier issue and show what changed.

Read the guide ↗
Submissions and review

Calibrate listing reviews across editors

Editors can apply the same written policy differently.

Read the guide ↗
Submissions and review

Separate payment status from editorial approval

A paid submission still needs to meet the directory's published requirements.

Read the guide ↗
Submissions and review

Handle a request to update a published listing

An update request may affect identity, contact details, or the service description.

Read the guide ↗
Submissions and review

Handle a listing removal request

Removal requests need a clear owner and record of the action taken.

Read the guide ↗
Submissions and review

Write review notes another editor can use

Review notes should capture evidence and unresolved questions.

Read the guide ↗
Submissions and review

Triage irrelevant directory submissions

Irrelevant submissions should be separated from incomplete but plausible contributions.

Read the guide ↗
Submissions and review

Set a realistic submission review expectation

A review estimate should reflect team capacity and the type of submission.

Read the guide ↗
Publishing and migration

Choose between a directory path and subdomain

The choice affects navigation and technical setup.

Read the guide ↗
Publishing and migration

Prepare a custom domain publishing checklist

A domain launch requires more than a name that resolves.

Read the guide ↗
Publishing and migration

Choose one canonical destination for a directory

Multiple accessible copies can confuse maintenance and search signals.

Read the guide ↗
Publishing and migration

Plan a listing URL change before renaming it

A title change does not always require a URL change.

Read the guide ↗
Publishing and migration

Check directory links before launch

A directory's value depends on its destinations working.

Read the guide ↗
Publishing and migration

Choose a representative launch review sample

Launch review should include the edge cases visitors will encounter.

Read the guide ↗
Publishing and migration

Move a spreadsheet directory into a published site

Migration should preserve useful information while improving the visitor experience.

Read the guide ↗
Publishing and migration

Plan a move from an existing directory site

A directory migration includes content, URLs, and operational habits.

Read the guide ↗
Publishing and migration

Review a draft listing before publishing

A draft can be complete internally while still reading poorly as a public page.

Read the guide ↗
Publishing and migration

Unpublish an outdated listing deliberately

Unpublishing changes what visitors can find and what existing links do.

Read the guide ↗
Publishing and migration

Assign owners for directory launch tasks

Launch tasks cross content, domain configuration, review, and support.

Read the guide ↗
Publishing and migration

Create a final publication checkpoint

A publication checkpoint confirms that content and routing were reviewed together.

Read the guide ↗
Publishing and migration

Prepare support notes for a directory launch

Support needs to understand the new directory's structure and common contributor questions.

Read the guide ↗
Discovery and search

Explain integrations by the task they support

An integration listing should tell visitors what moves between systems and what work it enables.

Read the guide ↗
Discovery and search

Distinguish native integrations from third-party workflows

Visitors need to know who provides and supports the connection.

Read the guide ↗
Discovery and search

Explain how resources are selected for a directory

Selection criteria help visitors understand the directory's scope and editorial judgment.

Read the guide ↗
Discovery and search

Make an expertise directory useful for discovery

Expertise is easier to assess through specific work and scope than through broad labels.

Read the guide ↗
Discovery and search

Design member discovery around visitor needs

A member directory can serve networking, referrals, or public discovery.

Read the guide ↗
Discovery and search

Review directory search queries for intent

A query report is a sample of how people found or encountered your pages.

Read the guide ↗
Discovery and search

Audit directory page titles for distinct meaning

Titles should identify the page and its useful scope.

Read the guide ↗
Discovery and search

Write a useful description for a directory page

A description should summarize what the page offers, not promise a search position or repeat a keyword list.

Read the guide ↗
Discovery and search

Review empty categories before exposing them to search

An empty category usually provides little discovery value.

Read the guide ↗
Discovery and search

Review filter URLs for duplicate content

Filter combinations can create many URLs with little distinct value.

Read the guide ↗
Discovery and search

Write descriptive internal links in a directory

Link text should tell visitors where they will go.

Read the guide ↗
Discovery and search

Investigate a directory page missing from search

A missing search result can have several causes, and a sitemap entry is not proof of indexing.

Read the guide ↗
Discovery and search

Review directory search appearance after publication

Search appearance needs observation over time.

Read the guide ↗
Revenue and inquiries

Explain what a featured listing includes

Featured placement should have a concrete benefit and a visible meaning.

Read the guide ↗
Revenue and inquiries

Label sponsored directory placements clearly

A sponsored placement should be recognizable in the browsing experience.

Read the guide ↗
Revenue and inquiries

Compare listing plans by concrete differences

Plan comparisons should describe actual capabilities and limits.

Read the guide ↗
Revenue and inquiries

Choose inquiry form fields that support routing

An inquiry form should collect enough context to reach the right recipient.

Read the guide ↗
Revenue and inquiries

Document how directory inquiries are routed

Routing needs a clear recipient and fallback.

Read the guide ↗
Revenue and inquiries

Write an inquiry confirmation that sets expectations

A confirmation should explain what happened and what the visitor can expect next.

Read the guide ↗
Revenue and inquiries

Review inquiry quality with a clear definition

Lead quality depends on the provider's task and criteria.

Read the guide ↗
Revenue and inquiries

Map a directory's discovery-to-contact funnel

A funnel helps connect browsing behavior to a meaningful action.

Read the guide ↗
Revenue and inquiries

Interpret outbound directory clicks

An outbound click indicates that a visitor left for a destination.

Read the guide ↗
Revenue and inquiries

Prepare a listing renewal review

A renewal is an opportunity to check whether the listing remains accurate and the paid benefit is understood.

Read the guide ↗
Revenue and inquiries

Onboard a paid listing contributor

A paid contributor still needs guidance on completing a useful profile.

Read the guide ↗
Revenue and inquiries

Plan a directory pricing experiment carefully

A pricing experiment should ask a specific business question and preserve clear terms for contributors.

Read the guide ↗
Revenue and inquiries

Separate directory revenue from activity metrics

Revenue, clicks, and inquiries describe different parts of the business.

Read the guide ↗
Teams and maintenance

Onboard a new directory editor

An editor needs examples and decision rules, not only access to the dashboard.

Read the guide ↗
Teams and maintenance

Choose clear workspace boundaries

Workspaces should reflect ownership and access needs.

Read the guide ↗
Teams and maintenance

Hand off an unfinished listing review

A handoff should preserve what was checked and what remains unresolved.

Read the guide ↗
Teams and maintenance

Set a directory maintenance cadence

Review frequency should reflect how quickly information changes and how important it is to visitors.

Read the guide ↗
Teams and maintenance

Run a useful broken-link review

A failed link check needs interpretation.

Read the guide ↗
Teams and maintenance

Identify stale listings without relying on age alone

An old review date is a signal to inspect, not proof that a listing is wrong.

Read the guide ↗
Teams and maintenance

Create a listing quality scorecard

A scorecard should make review criteria visible, not create a mysterious ranking.

Read the guide ↗
Teams and maintenance

Keep a directory publishing incident log

An incident log helps prevent repeated routing or content mistakes.

Read the guide ↗
Teams and maintenance

Maintain an inventory of directory API keys

API keys need clear ownership and purpose.

Read the guide ↗
Teams and maintenance

Document a directory webhook integration

A webhook handoff should explain the event, receiving system, and failure owner.

Read the guide ↗
Teams and maintenance

Choose what to automate in directory maintenance

Automation works best on well-defined decisions and repeatable checks.

Read the guide ↗
Teams and maintenance

Run a focused monthly directory review

A monthly review should connect activity with listing quality and unresolved work.

Read the guide ↗
Teams and maintenance

Create a directory operator runbook

A runbook makes routine work repeatable when the usual operator is unavailable.

Read the guide ↗