> ## Documentation Index
> Fetch the complete documentation index at: https://docs.directify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Add listings to your online directory

> Learn how to create and manage business listings with detailed fields for contact info, media, categories, and visibility settings to build a comprehensive online directory

Your online directory listings are powerful tools for showcasing businesses, resources, or items in your business directory website. Each listing can be enriched with comprehensive information to provide value to your directory visitors. Here's a detailed overview of all available fields:

### Basic Information

* **Name** (Required) - The primary identifier for your listing that appears in search results and headers
* **Description** - A comprehensive overview that helps visitors understand what you're offering in your online directory
* **Categories** - Strategic organization tools that improve navigation and discoverability in your business directory
* **Tags** - Additional classification keywords that enhance search functionality
* **Content** - A versatile markdown-enabled section where you can:
  * Create structured, formatted content
  * Incorporate high-resolution images and videos
  * Integrate external media through YouTube/Vimeo embeds

### Contact Details

* **Phone Number** - Professional contact number with international format support (e.g., +1234567890)
* **Email** - Direct communication channel for inquiries and correspondence
* **Address** - Physical location details with optional map integration

### Web Presence

* **URL** - Primary website link with intelligent auto-fill functionality
* **Social Links** - Comprehensive social media integration:
  * Multiple platform support (Twitter, Facebook, LinkedIn, etc.)
  * Direct profile linking
  * Customizable display order

### Media

* **Logo** - Brand identity through direct upload or URL reference
* **Cover Image** - Primary visual representation for your listing
* **Screenshot** - Automated website capture capability for enhanced visual presence

<Warning>
  Website screenshot functionality requires ScreenshotOne integration activation in your settings.

  Explore the complete [ScreenshotOne integration guide](/integrations/screenshotone).
</Warning>

### Visibility Settings

* **Published** - Control public visibility of your listing
* **Featured** - Priority placement for premium listings in your directory website
* **No Follow** - Advanced SEO control for external link management

### Expiring Listings

Every listing can be given an optional **start date** and **expiry date** on its edit page. Use them for time-limited entries — a paid placement, a job opening, an event, or a seasonal offer.

* **Start date** - The listing stays hidden until this moment, then appears automatically. Leave it empty to publish immediately.
* **Expiry date** - What happens once this moment passes depends on your directory's setting. Leave it empty and the listing never expires.

Choose the expiry behaviour under **Settings → General → Listing Expiry Settings**:

* **Keep it visible with an Expired badge** *(default)* - The listing stays in your directory with an "Expired" badge and is sorted last. You can customise the badge text.
* **Hide it from the directory** - The listing is removed from listing pages, search and the sitemap.

Either way the listing's own page stays reachable via a direct link, so existing inbound links and bookmarks don't break.

<Tip>
  Turn on **Show Expiry Countdown** in the same settings section to display a "3 days left" badge on listings approaching their expiry date — a useful nudge when you're selling renewals.
</Tip>

Both dates can also be set through the [API](/api-integration/projects), the [CLI](/ai-tools/cli) and the [MCP server](/ai-tools/mcp-server) via the `starts_at` and `ends_at` fields.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/directify/images/listing-demo.png" alt="Adding a new listing" />
</Frame>

## Strategic Tips

1. Utilize the URL auto-population feature for efficient listing creation
2. Implement a structured category and tag system to organize your online directory
3. Leverage markdown formatting for professional content presentation
4. Maintain current contact information for reliable user engagement
5. Prioritize high-quality visual assets to create an engaging business directory website

<Note>
  Featured listing functionality requires specific configuration in Directory Settings for optimal display management.
</Note>

***

<CardGroup cols={2}>
  <Card title="Listing Import" icon="pen-to-square" href="https://mintlify.com/docs/quickstart">
    Learn about importing listings
  </Card>

  <Card title="ScreenshotOne" icon="list-ul" href="https://mintlify.com/docs/development">
    Learn about ScreenshotOne integration
  </Card>

  <Card title="SEO" icon="pen-to-square" href="https://mintlify.com/docs/quickstart">
    Learn about SEO
  </Card>

  <Card title="Custom Fields" icon="list-ul" href="https://mintlify.com/docs/development">
    Learn about Custom Fields
  </Card>
</CardGroup>