> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Add a Custom Server Logo in FiveM

> Professionalize your project identity. Learn the technical requirements and configuration steps to upload a custom server icon for your FiveM community.

## Visual Branding & Identity

A custom server logo (frequently referred to as a Server Icon) is a fundamental component of professional project branding within the FiveM ecosystem. This graphical asset appears prominently next to your community's name in the global server browser and within the player's history tab. It serves as the primary visual hook that differentiates your server from competitors and establishes a recognizable brand identity. This guide ensures your asset meets the strict technical specifications required for the CitizenFX masterlist.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Beginner
  </Card>

  <Card title="Time" icon="clock">
    3 Minutes
  </Card>
</CardGroup>

***

## Technical Asset Specifications

The FiveM engine enforces rigorous constraints on the server icon to maintain a consistent and optimized user interface for all players.

* **File Format:** The asset **must** be a `.png` file. High-compression formats like `.jpg` or `.webp` are not supported.
* **Dimensions:** The image must be exactly **96x96 pixels**. Larger images will fail to initialize, and smaller images will appear distorted.
* **Transparency:** Alpha channels are fully supported, enabling the use of rounded corners, shadows, or custom-shaped branding.

***

## Deployment & Integration Workflow

Follow these steps to authorize and display your community branding.

<Steps>
  <Step title="Prepare the File">
    use a graphic editor (e.g., Photoshop or Canva) to export your logo as a 96x96 pixel `.png`. Rename the file to a simplified identifier, such as `logo.png` or `icon.png`.
  </Step>

  <Step title="Upload to Root">
    Log in to the [FREAKHOSTING Game Panel](https://games.freakhosting.com) and open the **File Manager**. Upload your image directly into the server's root directory (the same folder containing your `server.cfg`).
  </Step>

  <Step title="Update Server Configuration">
    Open your `server.cfg` file and locate or add the `load_server_icon` variable.

    ```cfg theme={null}
    load_server_icon logo.png
    ```
  </Step>

  <Step title="Initialize the Identity">
    Save the configuration and **Restart** your server.
  </Step>
</Steps>

***

<Note>
  ### Understanding Icon Propagation

  Following a server restart, the global masterlist may require several minutes to synchronize your metadata and update the icon in the public browser. If your branding does not appear immediately, use the "Direct Connect" feature to your own IP to force a local metadata refresh on your client.
</Note>

***

<Note>
  ### Need Extra Help?

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

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **FiveM:** Branding active.
</div>