Skip to main content
A custom FiveM loading screen is a resource with a web page (HTML, CSS, images, music) and the line loadscreen 'index.html' in its fxmanifest.lua. To add one, upload the resource on the Resources page, switch on Start at boot, switch it off for any other loading screen such as example-loadscreen, and restart. Players see it while they join.

What does a FiveM loading screen resource look like?

The fxmanifest.lua:
loadscreen sets the HTML file that FiveM shows as the loading screen. Every file the page uses must be listed under files, or players don’t receive it.

Which loading screen options can I add?

Details: FiveM loading screens documentation.

How to add a custom loading screen

1

Get or build the screen

Use a ready-made loading screen resource, or build your own index.html with the structure above. Test the page in your browser first.
2

Zip and upload it

Zip the folder so fxmanifest.lua is inside. On Resources, click Upload a resource and choose the zip (up to 100 MB).
Upload a resource box on the FiveM Resources page, with a drop area for a zip containing fxmanifest.lua, a Choose a zip file button and an Up to 100 MB limit

Upload your loading screen as a zip

3

Turn off the old loading screen

Search for example-loadscreen (and any other loading screen) on Resources and switch off Start at boot. Run only one loading screen.
4

Start yours

Switch on Start at boot for your loading screen and restart the server.
5

Test it

Join the server. If you still see the old screen, clear your FiveM cache.

How do I show the player’s name on the loading screen?

Server scripts can send data to the loading screen with deferrals.handover in the playerConnecting event. The page reads it from window.nuiHandoverData, which also includes serverAddress:

Tips for a good loading screen

  • Keep it light. Compress images and videos. Players on slow connections see the screen longest.
  • Keep music quiet. Start audio at a low volume (0.3 or lower) and give players a mute button with loadscreen_cursor 'yes'.
  • Use your own media. Only use music, videos and images you have the right to use.
  • Show useful info. Your Discord link, rules and server name help new players.

How to add music with a volume and mute button

A small script in index.html keeps the music quiet and lets players mute it. Add loadscreen_cursor 'yes' to fxmanifest.lua so they can click the button.
List music.mp3 under files in fxmanifest.lua, like every other file the page uses.

Can the loading screen be a website?

Yes. loadscreen also accepts an https:// address, for example loadscreen 'https://example.com/loading/'. The page then loads from your web host instead of the resource. This keeps the resource small, but if the website is down or slow, players see a blank screen. A resource with local files is more reliable.

How to update your loading screen

  1. Change the files on your computer and test index.html in your browser.
  2. Upload the changed files into the resource’s folder in Files, or upload the whole zip again on Resources.
  3. Run ensure my-loadscreen in the console, or restart the server.
  4. Join again. If you still see the old version, clear your FiveM cache: FiveM keeps downloaded files between visits.

Frequently asked questions

Is there a FiveM loading screen maker?

Several online tools and templates create the HTML for you. Whatever you use, the result must be a resource with loadscreen in its fxmanifest.lua, as shown above.

Why does my FiveM loading screen stay black?

Usually a file is missing from files, or a path in index.html is wrong. File names are case-sensitive on the server. Check the console for errors when the resource starts.

Why does the loading screen never close?

loadscreen_manual_shutdown 'yes' is set, but no script closes the screen. Remove the line or add a script that calls SHUTDOWN_LOADING_SCREEN_NUI.

Can I use a YouTube video as the background?

It is more reliable to include a short, compressed video file in the resource. Embedded web videos can be blocked or slow to load.

Can I have two loading screens?

Run only one loading screen resource and switch off Start at boot for the others, so players always see the one you expect.

FiveM server guide

Every FiveM guide in one place.

Install mods and resources

The Resources page step by step.

Add a server logo

Your icon in the server list.

Couldn't find resource

When a resource won’t start.
Reviewed by the FREAKHOSTING team on 29 October 2026. Game Panel steps were checked on our panel (FXServer build 35245 (Recommended) with txAdmin); game and plugin details follow their official documentation. Steps may differ slightly if FiveM, txAdmin or the resource change.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: October 2026