Adding a directory to WordPress usually means installing a plugin — then dealing with conflicts, shortcodes, and slow page loads. There's a simpler approach.
Before You Start
You'll need an EmbedDirectory account to create and embed a searchable directory on your WordPress site. No plugin required — works with any theme and page builder.
Start 7-Day Free Trial See Examples
Try free for 7 days. No coding required.
Step 1: Set Up Your Directory Fields
Start by defining what information each listing should contain. EmbedDirectory includes common fields by default (name, description, and address for location-based directories), and you can add custom fields for anything else you need.
How to Configure Fields:
- Log in to your dashboard
- Navigate to Set Up Listing Fields
- Click "Add Field"
- Choose from the available field types:
- Text fields (names, descriptions)
- Images (logos, photos)
- Links (website, social media)
- Buttons (call-to-action)
- Categories (tags, types)
- Contact information (phone, email)
- Location data (address, coordinates)
- And more...
Think about what visitors will search and filter by. A staff directory might need department and title fields. A business directory benefits from category and location fields. You can always modify fields later.
For help configuring fields, see How to Set Up Custom Fields or email us at hello@embeddirectory.com.
Step 2: Add Your Listings
Option 1: Add Listings Manually
- Go to Manage Listings
- Click "Add New Listing"
- Fill in your fields
- Save the listing
Option 2: Import from a Spreadsheet
- Go to Import Listings
- Upload a CSV file with column headers in the first row
- Map your columns to directory fields
- Run the import
For details, see How to Import from a Spreadsheet.
You can also keep your directory in sync with a Google Sheet that updates automatically. See How to Sync Google Sheets to Your Directory.
Step 3: Configure Your Directory Widget
Layout & Design
- Go to Widget Settings
- Choose your layout (grid, list, or map-first)
- Set your brand colors, background, and typography to match your WordPress theme
Search & Filters
Add search bars and filters so visitors can find what they need:
- Drag and drop to reorder them
- Set labels and placeholder text ("Search by name", "Filter by category")
- Choose which fields each search/filter targets
- Add toggle-style filters for yes/no criteria (e.g., "Open Now", "Featured")
Save your settings and preview how everything works.
Step 4: Add Map Features (Optional)
If your directory includes locations, add an interactive map:
- Make sure your listings have addresses
- Go to Map Settings
- Enable map features
- Create a free Mapbox account and add your access token
- Customize the map appearance:
- Choose a map style (street, light, dark)
- Set marker colors to match your brand
- Configure clustering for areas with many listings
Mapbox offers a free tier. Check Mapbox pricing for current limits.
Step 5: Add to Your WordPress Site
Copy your embed code from the Embed section of your dashboard, then paste it into your WordPress page.
Block Editor (Gutenberg)
- Edit the page where you want your directory
- Click the + button to add a block
- Search for and select Custom HTML
- Paste your embed code into the HTML block
- Click Update or Publish
Classic Editor
- Edit your page
- Switch to the Text tab (not Visual)
- Paste your embed code where you want the directory to appear
- Click Update or Publish
Page Builders (Elementor, Divi, etc.)
Most page builders have an HTML or code widget:
- Elementor: Add an HTML widget, paste the embed code
- Divi: Add a Code module, paste the embed code
- WPBakery: Add a Raw HTML element, paste the embed code
For best results, use a full-width page template in your WordPress theme. This gives your directory plenty of room for search bars, filters, and listings. Most themes and page builders offer a full-width option in the page settings.
Step 6: Enhance Your Directory
No Plugin Required
Unlike traditional WordPress directory plugins, EmbedDirectory runs independently. There's nothing to install, update, or maintain on your WordPress site. This means no plugin conflicts, no impact on page speed, and it works with any theme.
Enable User Submissions
Let visitors submit listings for your review by connecting a form builder integration — choose from JotForm, Typeform, or Tally.
Incoming submissions appear in Submissions, where you review and approve them before they go live.
Custom Styling
Want the directory to match your WordPress theme exactly? Email us at hello@embeddirectory.com with a link to your page and we'll help adjust styles for a seamless fit.