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

Project Assets not appearing in Media Library

  • Processing may still be in progress—poll until complete
  • Filter Media Library: upload.php?vexal_gallery={project_id} (query arg name retained)
  • 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

Portfolio association missing

  • Uploader step 2 (optional Portfolio) was skipped—association is optional by design
  • Assign Portfolio membership from the Portfolio editor or the Project → Portfolios section
  • Attachment Portfolio links store in _vxp_showcase_project_ids (meta key retained; user-facing label is Portfolios)
  • Vexal Project column = Project (vxp_portfolio); Vexal Portfolios = Portfolios containing that Project

Uploaded Assets not visible on public Portfolio

Expected in Phase 1. Upload organizes and optimizes Project Assets—it does not auto-publish Portfolios. An admin must assign the Project to a Portfolio and publish with the shortcode. Publishing sync is a future feature, not a bug.

  1. Verify Assets processed in Media Library
  2. Check Project Gallery / Asset pools for destination pools
  3. Assign Project to a Portfolio
  4. Publish or update the Portfolio 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