// troubleshooting guide · owncloud

ownCloud Virtual Files Not Working on Windows

Status
Workaround available
platforms:
Windows
updated:
November 16, 2026
reports:
4
Method
how we research
Share

RUNBOOK · owncloud/virtual-files-not-working4 FIXES

// quick answer

Virtual files need Windows 10 1709+ and the client's wincfapi plugin. Update the client, confirm the plugin in About, and reinstall if placeholders still don't appear; old 2.7.x builds had placeholder bugs.

Most likely fix: Update the client

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Update the client

    1. 01Install the latest client for your server (6.x for Classic, 7.x for Infinite Scale)
    2. 02Restart Windows Explorer or reboot
    Did this fix it?
  2. FIX 2Check the plugin

    1. 01Open the client's About dialog
    2. 02Look for 'wincfapi' as the virtual files plugin
    3. 03Confirm Windows 10 version 1709 or later
    Did this fix it?
  3. FIX 3Toggle virtual files

    1. 01In the account's folder menu, disable virtual file support, let it finish, then enable it again
    Did this fix it?
  4. FIX 4Clean reinstall

    1. 01Uninstall the client and reboot
    2. 02Reinstall and add the account again; users report this restores placeholders
    Did this fix it?

Symptoms

Folders sync but files inside don't appear, files open as 0 KB, or Windows counts virtual files as fully downloaded and fills the disk.

Why it happens

  • C-01Old client (2.7.2 and earlier mishandled placeholder errors)
  • C-02Windows version without the Cloud Files API
  • C-03Conflict with other cloud file providers (OneDrive, Teams)
  • C-04Broken client installation

// this guide also covers

  • owncloud virtual files not working
  • owncloud files on demand
  • owncloud vfs windows
  • owncloud files 0 kb

Still not working?

If ownCloud keeps failing, you're not alone. See every ownCloud problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch ownCloud Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other ownCloud errors

All 12 ownCloud errors and fixes →