How to Add Website Thumbnails to a WordPress Directory Made with GeoDirectory in India
Add listing images or website screenshots to GeoDirectory, configure archive cards and fallbacks, and fix common thumbnail issues.
To add a thumbnail to a GeoDirectory listing, edit the listing and upload an image in its Images field. Put the image you want displayed first: GeoDirectory uses the first listing image as the featured image. Then configure GD Post Images in the archive item or detail template to show a single image, slider, or gallery. If by “website thumbnail” you mean a screenshot of the website in the listing’s URL field, GeoDirectory also documents a URL Screenshot image type; its setup depends on the URL field key and template configuration.
The documented setup is general to GeoDirectory and WordPress; the reviewed sources do not describe a separate India-specific thumbnail setting. Your installed GeoDirectory version, theme, and field configuration determine the exact screens and output.
Choose the kind of thumbnail you need
| Thumbnail source | Best for | Where it comes from |
|---|---|---|
| Uploaded listing image | A company logo, storefront photo, or chosen promotional image | The listing’s Images field (post_images) |
| Website screenshot | A visual preview of the website linked from the listing | A URL Screenshot image type associated with the listing’s URL field |
These are different sources. An uploaded image gives you control over the exact artwork. A screenshot represents the linked site and can change as that site changes. Decide which source should appear on archive cards and detail pages before adjusting the template.
Upload and feature a listing image
- In the WordPress dashboard, open the relevant listing to edit it. To create one in the backend, GeoDirectory’s guide uses Places > Add New. If your site allows frontend submissions, open its Add Listing page instead.
- Find the listing’s Images field and upload the image. GeoDirectory identifies the field key as
post_images; images are not required for a listing. - Order the images so the desired thumbnail is first. GeoDirectory treats the first image as the featured image and uses it when a single image is displayed.
- Save or publish the listing, then preview it in the directory archive and on its detail page.
If you need to set or change the frontend submission page, go to GeoDirectory > Settings > General > Pages > Add Listing page. That page uses the GD Add Listing element to render the form. The backend and frontend labels can vary with your installed version and site setup.
Show listing images on archive cards and detail pages
- Open the GeoDirectory archive item or detail template used by your theme or page builder.
- Add or edit the GD Post Images element. It is included in the default GD Detail and GD Archive Item templates.
- Choose the presentation: Single Image for one thumbnail, Slider for multiple images with navigation, or Gallery for a grid.
- Choose an available WordPress image size and review the element’s cover setting. Cover behavior can crop image edges to fill the display area.
- Preview both an archive card and a listing detail page at desktop and mobile widths. A theme may also display the featured image in a banner or header.
If the theme adds a featured image above the detail content and you do not want that duplicate, check GeoDirectory > Settings > Design > Detail. GeoDirectory documents a setting there that may disable theme featured-image output. Confirm the effect with your active theme.
Use a screenshot of the listing’s website
GeoDirectory’s Post Images documentation lists URL Screenshot as an image type. Its example uses a URL field with key url and the corresponding screenshot key convention url_screenshot. The listing setup guide also describes a generated website screenshot as a possible fallback when a listing has no image.
- Check the actual field key for the website URL on your site. Do not assume it is
url; custom fields and site configuration can use another key. - In the GD Post Images configuration, select the URL Screenshot image type and associate it with the correct URL field key using the convention documented for your setup.
- Choose where it should display: the archive item, detail page, or both. Verify the result with a listing that has a valid website URL.
- Test a listing with no uploaded image as well as one that has an uploaded image, so you can confirm whether the screenshot is used as the intended fallback.
The GeoDirectory sources describe the image type and a fallback possibility, but do not establish that every installation automatically generates screenshots without configuration. Behavior depends on the field key and template setup. If the option is absent, check your installed GeoDirectory version and the current widget documentation before changing fields.
Set image size, cropping, and responsive display
GeoDirectory’s GD Post Images element offers WordPress image sizes, and the selected size can be adjusted in its settings. WordPress Media settings control the available image sizes. GeoDirectory says responsive output is used by default, though a theme can affect which image is served.
- Blurry thumbnail: inspect the selected size in GD Post Images and the available sizes under Settings > Media. Check whether the theme substitutes a smaller image.
- Unexpected crop: review the image cover setting and the source image’s aspect ratio. Cover-style display fills the box by cropping edges.
- Different desktop and mobile appearance: preview both breakpoints; theme styles can affect the rendered dimensions.
- Logo looks too small inside the thumbnail: use a source image with less empty space around the logo or adjust the template’s image presentation.
Configure a fallback for listings without an image
GeoDirectory documents fallback options that can include a company logo, category default image, custom-post-type default image, or listing default image. The GD Post Images widget uses the first fallback type that has a value.
- Choose which fallback makes sense for your directory: a category-specific image, a general default, or a company logo.
- Set category defaults on the category edit screen, the custom post type default in its settings, or the listing default under GeoDirectory design/archive settings.
- Check the fallback order with a listing that has no uploaded image, then check a listing that has an uploaded image to ensure the fallback does not replace real listing artwork.
- Set
fallback_types=0when you want no fallback image to display.
Troubleshooting
| Symptom | Likely cause | What to check |
|---|---|---|
| The wrong uploaded image appears as the thumbnail | The intended image is not first in the listing’s ordered Images field. | Reorder the images so the preferred image is first, save, and reload the archive card. |
| No image appears on the archive card | The archive item template may not contain GD Post Images, or its selected source may not have a value. | Edit the archive item template, add or configure GD Post Images, and confirm the listing has an image or a configured fallback. |
| A website screenshot does not appear | The URL Screenshot image type may be tied to the wrong URL field key, or the template may not be configured to use it. | Verify the listing URL field key and screenshot mapping. Test a listing with a valid URL and inspect the widget’s image type and fallback settings. |
| A fallback appears when it should not | A fallback type has a value and is enabled. | Review the fallback sequence and its configured values; use fallback_types=0 to show no fallback. |
| The image is blurry | The selected WordPress image size may be too small, or theme behavior may serve a smaller variant. | Review Settings > Media, the GD Post Images size, and the theme’s output. |
| The image is cropped unexpectedly | The cover setting fills the image area by cutting off edges, or the source aspect ratio does not match the template. | Review the cover setting and use an image whose proportions suit the thumbnail area. |
| The image is duplicated on the detail page | The template element and theme featured-image banner may both be rendering the same featured image. | Check the GeoDirectory Design > Detail setting for theme featured-image output and preview the active theme. |
| The submission form has no image field | The frontend form or listing configuration may not include the Images field, or the account may not have the required submission access. | Check the Add Listing page, form configuration, and role/site settings. GeoDirectory’s image field is optional. |
Performance, reliability, and cost considerations
For uploaded images, choose a size that remains clear at the largest place it appears; serving an unnecessarily large original for a small card can waste bandwidth. WordPress and GeoDirectory provide image-size and responsive-output controls, but the active theme may affect delivery. Check the rendered page rather than assuming the editor preview matches the final result.
A URL screenshot represents a remote website, so its availability and appearance depend on that site and on how the GeoDirectory installation is configured to obtain and display the screenshot. The supplied GeoDirectory documentation does not specify a capture benchmark, reliability guarantee, or cost for this feature. Test representative URLs and fallback behavior before relying on screenshots across every listing.
Or skip the browser setup
If you want to generate website preview images yourself, ScreenshotNeo is a website screenshot API and MCP server for developers. A GET request returns an image or PDF. Here is a one-call image example; replace the target URL with the listing website you want to capture:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
See the ScreenshotNeo API documentation for the request options. ScreenshotNeo accepts cookie and consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing, and response headers report the page verdict and billing status. Its MCP server lets AI agents use take_screenshot, get_page_info, and capture_pdf. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots.
Sign up for 1,000 free screenshots a month, with no card required.
FAQ
Is the listing Images field required?
No. GeoDirectory documents the field as optional, so configure a fallback if listings may be submitted without an image.
Can I use a different URL field name from url?
The documentation’s example assumes the key url. Check the actual field key on your site and configure the URL Screenshot type to match it.
Does the India location change the GeoDirectory setup?
The reviewed GeoDirectory and WordPress documentation describes general behavior and does not identify a separate India-specific thumbnail setting.
Which display should I choose for a directory card?
Use Single Image when a card should show one compact preview. Use a slider or gallery when visitors need to browse multiple listing images.


