Vexal Documentation by WileyLabs

Vexal Portfolio Troubleshooting

Common Vexal Portfolio issues and how to resolve them.

Uploader does not show

  • Verify shortcode [vexal_project_uploader] is on the page (parameterless)
  • Enable Project Workspace in Portfolio → Settings (workspace_enabled—default is off)
  • Confirm Vexal Media is installed and active
  • Processing must be ready—check Vexal Media dashboard for queue/API status
  • Page must not be cached for logged-out users if uploader requires auth (check plugin settings)
  • Theme/builder must render shortcodes in content area

Workspace disabled

Project Workspace is off by default. Toggle workspace_enabled in Portfolio → Settings. Without it, the uploader shortcode will not render and Project Workspace menu is hidden.

Vexal Media missing

Portfolio uploader requires Vexal Media for processing. Install and activate Vexal Media, configure processing, then retry upload.

Processing unavailable

  • Configure API credentials in Vexal Media—not in Portfolio Workspace
  • Check Vexal Media queue for stuck or failed items
  • Verify server can reach processing endpoints (firewall, SSL)
  • For video uploads, ensure video optimizer is configured (API or FFmpeg)
  • Review submission record (vxp_submission) for batch ID and error state
  • Processing may still be in progress—poll until complete
  • Filter Media Library: upload.php?vexal_gallery={portfolio_id}
  • Grid view filter requires Vexal Media 1.6.015+ for AJAX query[vexal_gallery]
  • Run Media Linkage sync in Portfolio admin
  • Attachment may lack _vxp_portfolio_item_id meta—run Media Linkage
  • Upload may have failed before organization step completed
  • Manually assign in attachment metabox (respect sync lock)
  • Vexal Media columns require Vexal Media plugin active

Project / showcase association missing

  • Step 2 (Optional Project) was skipped—association is optional by design
  • Assign showcase manually in attachment metabox or Media Linkage
  • Showcase link stores in _vxp_showcase_project_ids on attachment
  • Vexal Project column = showcase (vxp_project), not the gallery record

Uploaded media not visible on public gallery/project

Expected in Phase 1. Upload organizes and optimizes media—it does not auto-publish showcases. An admin must build portfolio displays from organized pools. Publishing sync is a future feature, not a bug.

  1. Verify media processed in Media Library
  2. Check Project → Manage gallery for destination pools
  3. Assign project to Showcase
  4. Publish or update the showcase page with [vexal_portfolio id="slug"]

Workspace tabs show “Coming soon”

Expected. Only the Media tab placeholder is active in Phase 1. Overview, Story, Publishing, Visibility, Requests, and Activity tabs are future.

See also