Troubleshooting
Each section below starts with the cause that turns out to be right most of the time.
1. My archives return a 404
Check the permalinks. Go to Settings → Permalinks and pick anything other than the default. RetroTube does not change this for you, and the category, tag and actor archives are all built on pretty permalinks.
Saving that screen also flushes the rewrite rules, which fixes the same symptom when they have gone stale after a plugin change. It is worth doing even if the setting already looks right.
This is also the first thing to check when a photo gallery or a blog post 404s: both register their own URLs, and those need the rules rewriting too.
2. I cannot find the settings
They are not in the Customizer. RetroTube has its own admin page, RetroTube in the WordPress menu.
3. My menu is replaced by Main Menu
Before version 1.16.0, the theme put its Main Menu back in the header on every page, whatever menu you had chosen in Appearance → Menus. Update the theme: the menu you choose now stays.
4. Submenus or the mobile menu do not open
Before version 1.16.0, a cache or optimization plugin that merges JavaScript files (like WP-Optimize) broke the submenus and the mobile menu. Update the theme, then empty the cache of that plugin.
5. The Submit a video or My Profile link leads to a 404
Before version 1.16.0, these links broke once the slug of their page had changed. Update the theme. If the link still fails, open the Pages tab and check a page is chosen for each role: a missing one can be recreated from there.
6. A video shows no player
Check which source field you filled in: Video URL for a file you host, Embed code for the code a provider hands you. Pasting an iframe into the Video URL field is the usual cause. See Video Information.
7. The homepage carousel is empty, or missing
Two causes, in this order. The carousel only holds videos marked with the Featured video switch, so an empty one usually means nothing is marked yet. If videos are marked and it still does not appear, check Show carousel of videos in Homepage, and, if the page you are looking at is a phone, Show carousel on mobile next to it.
8. Hover previews do nothing
Two things have to line up: Enable thumbnails rotation has to be on in General, and the video needs either a Video trailer URL or images in its Thumbnails field. A video with neither simply shows its thumbnail.
9. My sidebar is blank
The sidebar prints whatever is in its widget area, and nothing when the area is empty. Fill it at Appearance → Widgets, as described in Widget Areas.
Remember that four separate settings can hide it: the global one in Sidebar, and the overrides on the homepage, the video pages and the category pages.
10. My footer columns do not line up
The column count and the number of widgets have to match. Set the count in Footer, then put exactly that many widgets in the footer area.
11. The submission page tells members to log in
That is what it does: the form is for logged-in members only. Check Enable membership and Enable video submission at RetroTube → Membership, and that WordPress itself allows registration at Settings → General.
12. A member cannot upload a file
The upload limits come from PHP, not from the theme: the figures shown in the Membership panel are your server's. Raising them is done in your hosting configuration.
Check as well that the file fields are switched on in Video submit settings, and that the file is one of the accepted types: mp4 for video, jpg, png, gif or webp for a thumbnail.
13. Nobody can register
Two settings have to agree. The theme's Enable membership shows the forms; WordPress decides if an account can be created at all, at Settings → General, Membership: Anyone can register.
14. My blog is empty
Blog posts live under Blog in the WordPress menu, not under Posts,
and the blog is shown at its own address, /blog/ by default. A page you
created for the blog shows nothing: there is no need for one, link to the blog
address instead.
15. A page of the theme appears twice
Older versions created a page again after it was renamed. Update the theme, then open the Pages tab: the other pages using the same template are listed there with a Move to trash link.
16. Ad zones stay empty
An empty ad field prints nothing at all, by design: no placeholder, no gap. So an ad zone that looks missing is usually a zone that was never filled in.
The mobile ad zones are set separately, in the Mobile section, and the desktop ones do not apply there.
17. I imported a niche and lost my settings
That is what importing does: it overwrites every option on every tab. If you took a backup from Export beforehand, import that file from the Niches tab to get them back. If you did not, the settings are gone and have to be entered again.
18. My changes are not applied
Check you saved the options page. If a change is saved but the site still looks the same, empty your caching plugin and your CDN before looking further.
19. Something else
If none of this covers it, open a ticket from your account with the URL of the page, what you expected and what you got. A screenshot saves a round trip.