Social feeds troubleshooting

The gallery is empty right after connecting

For YouTube, Vimeo, Flickr, VK, Twitch and Unsplash, check Source under Account in the block. A Vimeo, Flickr, Twitch or Unsplash gallery shows nothing while Source reads Choose a source. See Social.

The import runs in the background after you save the settings. Open Visual Portfolio → Social Items: if it is empty after a few minutes, click Sync Now. If items still do not appear, WP-Cron or loopback requests are blocked: see CRON and Tools → Site Health.

The preview shows an error in place of the items

The editor fetched a new source and the network refused it. The message is the network’s reason, such as a wrong ID or a missing permission. Fix the value in Source or the account in Settings → Social Feeds. The editor tries the same source again when the preview updates five minutes or more after the failure.

“This source is still loading. Reload the editor in a minute.” means another sync was running. Reload the editor after a minute.

Flickr: “Add the Flickr profile URL in the connection settings to list its albums.”

The Album dropdown needs the account’s Profile URL. Add it in Settings → Social Feeds → Flickr, or enter the album URL in the field below the message.

A feed stopped updating

A feed syncs while a gallery shows it. If no page with its gallery was built by WordPress for 30 days, for example because a page cache served the same copy, the sync stops. The next view of the page starts it again.

Items show the placeholder image

Images are downloaded after the items are created. Downloading needs cURL or allow_url_fopen in PHP, a writable wp-content/uploads/visual-portfolio-pro/ folder, and GD for thumbnails. Some CDNs refuse requests from servers (403); such hosts are skipped until the next full sync. Ask your host to enable the PHP requirements if the folder stays empty.

Instagram: “Your Instagram API connection is using outdated keys”

The account was connected through the retired Basic Display API. Click Reconnect, log in with a Business or Creator account, and save.

Instagram videos stopped playing

Instagram’s video links expire. The sync refreshes them and keeps a local copy; if the site’s cron was not running for days, run Sync Now.

Captions with emoji are missing or the feed does not load

The database must use the utf8mb4 character set. The Instagram tab warns “Be careful, your database encoding may not work properly with Instagram posts data” when it does not. Ask your host to convert the tables (wp_posts, wp_postmeta, wp_options) to utf8mb4 with the utf8mb4_unicode_ci collation. Back up first.

Captions or counts do not update

Existing items are never updated by a sync. Edit the Social Item, or Purge Cache the account to re-import everything.

Deleted items come back

Deleting an item permanently lets the sync recreate it. Leave unwanted items in the Trash, or use the Exclude from Sync bulk action.

“Sync already in progress”

Another sync holds the lock, for at most five minutes. Wait and retry.

YouTube: quota exceeded

See the YouTube page for the cost of a sync. Every playlist a gallery shows is synced on its own. Lower Max Videos or the number of accounts and playlists, or request a higher quota from Google.

X: “Bearer Token is good, check your query”

Max Tweets above 100, a wrong Account Name, or an API plan without read access.

Vimeo: “Please check your Data!”

Wrong credentials, missing token scope, or a value in Source that does not match its kind. A showcase takes its number or its URL.

The page cache shows the old feed

LiteSpeed, W3 Total Cache, WP Fastest Cache, WP Super Cache and WP Rocket are purged automatically when new images arrive. For other caches, purge the pages with social galleries or exclude them from the cache.

Social Items is missing from the menu

It appears once an account (other than Unsplash) is connected or an item exists.