What to do when something doesn’t look or react as expected – sorted by what you observe.
| Observation | Cause | Fix |
|---|---|---|
| Exhibitor pages show “Page not found” | The address rules don’t know the URL path yet – after installation or after changing the URL slug. | Open Settings → Permalinks and save without changes. |
| “Please provide a parent_id.” instead of the list | The shortcode lacks parent_id. | Enter the event ID, easiest via the Shortcode Generator. |
| List empty although exhibitors exist | Wrong parent_id, exhibitors without an event, drafts or “map only”. | Check the dashboard (“Unassigned Event”) and the entries’ status. |
| “No hall plans available for this event.” | No plan is attached to the event – or it was accidentally saved on an exhibitor. | Add the plan in the event’s “Hall plans” box. |
| Hall plan stays white | The SVG file is broken, has no dimensions or contains embedded foreign content. | Open the file directly in the browser; save again as plain SVG with viewBox. |
| Booths can’t be clicked | ID doesn’t match the booth ID – or “Hide all location & booth information globally” is set. | See Linking booths. |
| “View on map” is missing | The exhibitor’s location doesn’t occur in any of the event’s plans, or hide_map_icon="true". | Assign a location or enter it as a room in the plan. |
| SVG can’t be uploaded | WordPress blocks SVG by default. | Have SVG upload enabled (e.g. plugin “Safe SVG”). |
| Directory colors differ from the back end | The “Design & Display” tab was never saved. | Save it once. |
| Mass Editor doesn’t save (403 / 500) | Usually a security plugin or firewall blocks the AJAX requests. | Check in the developer tools (F12, Network); adjust the firewall rule or save fewer rows at once. |
| Mass Editor: “Duplicate booth number detected!” | Two exhibitors carry the same booth number. | Assign a unique number. |
| Dashboard, Mass Editor or Import menu items missing | The role may not edit other users’ posts. | Editor or administrator role – see Roles & permissions. |
| “Global Hall Plan Page” is empty after saving | Known limitation of this version. | Not needed: “View on map” opens the plan as a window. |