Two listings sit next to each other in a Google search result. Same directory, same category, similar businesses. One shows a star rating, an address, and a phone number right under the title. The other is a plain blue link with a one-line description. Same content underneath, different presentation on the page that decides whether someone clicks.
That difference comes down to one setting: schema markup.
The problem of not using schema markup
Search engines don’t read a listing page the way a person does. Without extra signals, Google sees a title, a block of text, and an image, and has to guess what kind of content it’s looking at. A restaurant listing, a job posting, and an apartment listing can all look structurally identical to a crawler. So Google plays it safe and shows a plain snippet: title, URL, meta description. Nothing that stands out.
For a directory owner, that means every listing is competing for clicks on text alone, even when the underlying data (ratings, address, phone number, hours) is already sitting in the database.
What schema markup actually does
Schema markup is structured data, added in JSON-LD format, that tells search engines exactly what a piece of content represents: a local business, a job posting, an event, and so on. Under the hood, Directorist hooks this into wp_footer and prints a <script type="application/ld+json"> block on every single listing page, built automatically from that listing’s own data. Nothing to edit in a template, nothing to touch in code.
It’s worth being precise here: enabling schema makes a listing eligible for rich results. Google still decides whether and when to render them. This is a visibility and click-through improvement that helps in ranking.
How it works, section by section
The setting lives at WP Admin Dashboard → Directorist → Settings → Site & Pages → Schema , and it’s built around three decisions.
1. Enable Schema Markup
This is the master toggle. Turn it on, and Directorist starts generating JSON-LD for every single listing page automatically, based on whatever schema type is selected.
Benefit for the owner: structured data across your entire directory without touching a line of code. If this toggle is off, nothing is printed at all, so there’s zero performance cost to sites that don’t use it.
2. Apply Schema To
his decides the scope: All Directories, which applies one schema type across your whole site, or Per Directory, which lets you assign a different schema type to each directory you run (only relevant if Multi-Directory mode is enabled).
Benefit for the owner: if you run a single-purpose directory, “All Directories” keeps setup to one decision. If you run a multi-directory site, say jobs, events, and local businesses under one roof, “Per Directory” means each section gets a schema type that actually matches its content instead of forcing everything into one generic type.
3. Schema Type
This is where you tell Google what kind of content each directory actually contains. Currently, Directorist supports eleven schema types: Business Event, Apartment Complex, Event, Festival, Job Posting, Local Business, Marketing Agency, Organization, Professional Service, Real Estate Agent, and Service.
Benefit for the owner: choosing the right type is what unlocks the relevant rich result. A job board using Job Posting can surface role and location details. A real estate directory using Real Estate Agent or Apartment Complex gets schema built for that industry instead of a generic business listing. This is a wider set of options than a general-purpose SEO plugin gives you out of the box, because it’s purpose-built for directory content.
What actually gets generated (and why it’s smarter than a static template)
Directorist doesn’t print the same fixed schema fields for every listing. It builds the JSON-LD dynamically, field by field, and only includes what’s actually present.
Name and URL are always included, pulled straight from the listing title and permalink, or the listing’s website field if one exists, which takes priority as the canonical URL.
Description is added only if a description field exists in that directory’s single listing layout, using the listing excerpt if one is set.
Address, meaning street and postal code, is added only if an address or zip field is part of the listing layout.
Geo coordinates, latitude and longitude, are added only if the listing has a map field, pulled from the stored manual coordinates.
Email is added only if an email field exists, and it’s run through WordPress’s sanitize_email function before output.
Phone numbers are added only if phone fields exist, and they’re formatted intelligently. Directorist detects a country code from WooCommerce’s default country setting if WooCommerce is active, or from the site’s locale, and prefixes numbers that don’t already start with a plus sign.
Ratings, the aggregate Rating field, are added only if reviews are enabled on the site and the listing has at least one review. No reviews, no fabricated rating shown to Google.
Social links, the same As field, are pulled from the listing’s saved social profile URLs, if any are set.
Any field that ends up empty gets stripped out before the JSON is generated, so you never ship broken or half-filled structured data.
Benefit for the owner: this means schema quality scales with how complete your listing layout is. A directory owner who has built out address, map, phone, and review fields in their Directory Builder gets a rich, multi-field schema automatically. A leaner directory still gets clean, valid schema with just name, URL, and description. There is no manual per-listing schema entry required either way.
What changes after it’s turned on
Before: a listing shows as a plain title and description in search results, indistinguishable from any other page on the internet.
After: once Google crawls and validates the structured data, eligible listings can show additional detail directly in the results, such as ratings, address, phone, and business type, depending on what fields that listing actually has filled in. That extra detail is what tends to draw the eye and increase click-through rate, even without a change in ranking position.
Where this doesn’t help
Schema markup won’t fix a listing that’s thin on content, and it won’t force Google to display rich results, since that decision sits entirely with Google’s algorithms. It also only prints on single listing pages, not archive or search pages. And it’s only as complete as your Directory Builder layout: if a directory’s single listing page doesn’t include an address or phone field, that data simply won’t appear in the schema, because Directorist won’t guess at data it can’t verify. The basics still matter too: fast page load, mobile-friendly layout, and genuinely useful listing content do most of the remaining work.
Try it
If you haven’t set this up yet, it takes about two minutes. Go to Directorist, then Settings, then Site & Pages, then Schema Markup. Enable it, pick your scope, and choose the schema type that matches your directory. Then check your Single Listing Page layout in Directory Builder, since the more fields you’ve added there, such as address, map, phone, and reviews, the richer your schema output will be. For more detail, you can check out documentation.
Leave a Reply