If your Vimeo import is not working in WordPress, you are dealing with one of a handful of well-defined problems. This guide covers the most common causes and provides step-by-step solutions so you can get your videos importing reliably using the Vimeotheque plugin.
Common Reasons Vimeo Import Fails in WordPress
1. API Credentials Not Configured or Invalid
Vimeotheque communicates with Vimeo through the official Vimeo API. If your Client ID or Client Secret is missing, incorrect, or has been regenerated on the Vimeo side, every import attempt will fail. Go to Vimeotheque → Settings → API and verify that both fields are populated and saved.
2. Video Privacy Settings Blocking the Request
Videos set to private, password-protected, or restricted to specific domains on Vimeo will return an error or no data when queried through a standard API token. If you need to import private videos, you need Vimeotheque PRO with a fully authorized OAuth connection and the correct Vimeo app permission scopes.
3. Incorrect Video URL or ID Format
The individual video importer accepts a full Vimeo URL or a numeric video ID. URLs from shared playlists, private album pages, or redirect links are not valid inputs. Use the direct URL as it appears in your browser address bar when viewing the video on Vimeo.
4. Plugin or Theme Conflict
Security plugins that block external HTTP requests, and some caching plugins that interfere with admin AJAX calls, can prevent the import from completing. Temporarily deactivate all non-essential plugins and retry the import to confirm whether a conflict is involved.
5. Server Blocking Outbound API Requests
Vimeotheque needs to reach api.vimeo.com over HTTPS. Some managed hosting environments block outbound HTTP requests by default. Check your hosting control panel or ask your provider to confirm outbound connections to the Vimeo API are allowed.
Step-by-Step Fix
- Open Vimeotheque → Settings → API and confirm your credentials are saved.
- Use the connection test link on that screen to verify the API responds correctly.
- Try importing a public video first to rule out privacy restrictions.
- Deactivate caching and security plugins temporarily, then retry.
- Check your server error log for any blocked outbound request entries.
- If importing in bulk, reduce the batch size to avoid timeout issues.
Once single-video imports work, you can scale up and import Vimeo videos into WordPress in bulk using the automatic importers available in Vimeotheque PRO.
When the Problem Is the Vimeo API Integration
If credentials and privacy are confirmed correct but imports still fail, the issue may be at the Vimeo API integration level. Your Vimeo app must have the public scope enabled as a minimum. For private video access, the private scope and an authorized OAuth token are required. Check the app’s scopes in the Vimeo Developer portal under your app’s “Authentication” tab.
Frequently Asked Questions
Why does Vimeotheque show no results after I enter a Vimeo URL?
This usually means the API credentials are invalid or the video is restricted. Test the connection in Vimeotheque settings and verify the video is publicly accessible on Vimeo.
Can I import private Vimeo videos into WordPress?
Yes, with Vimeotheque PRO and a properly authorized OAuth token. The Vimeo app must have private-read permissions, and you must complete the OAuth authorization flow inside the plugin settings.
Why do some videos import and others do not?
Per-video privacy settings on Vimeo control what the API returns. A video that is unlisted, domain-restricted, or password-protected will not import under a standard API token.
Does the import work on all hosting providers?
It works on any host that allows outbound HTTPS requests to api.vimeo.com. Hosts that restrict outbound traffic need to whitelist the Vimeo API domain.
How do I test whether my API credentials work?
Use the built-in connection test in Vimeotheque → Settings → API. A successful test confirms the credentials are valid and the server can reach the Vimeo API.
What is the difference between the individual importer and the bulk importer?
The individual importer handles one video at a time using a URL or ID. The bulk importer, available in Vimeotheque PRO, can import entire folders, showcases, or portfolios automatically on a schedule.