Hiddify Guide
中文 Download Hiddify

Hiddify Guide

Import a Profile into Hiddify and Choose a Proxy

Add the complete profile URL, wait for the refresh result, choose one proxy, and verify a real target connection. Keep the URL private. Require three separate signals before connecting: a profile name, a changed update time, and a populated proxy list. If any is absent, recover at that profile stage rather than changing routing mode or DNS.

Hiddify profile import guide feature image showing profile, proxy, and connection tasks
Start Hiddify profile import by adding a profile, then choose a proxy and verify the affected app.

Before importing

Prepare the Complete Profile URL, Then Open Add Profile

Copy the complete profile URL from the provider and open Add Profile on the Hiddify dashboard. Read it from the clipboard when the full URL is already copied, or choose Manually and paste it. Wait for the profile name to appear before opening the proxy list, and do not change routing mode, DNS, or TUN while an import failure is unresolved.

Profile URL, Profile, and Proxy Are Different Things

Profile URL

The complete provider URL used to retrieve a profile; keep token-like values private.

Profile

The saved record that Hiddify refreshes; its name appears on the dashboard after import.

Proxy

A selectable connection entry loaded from the profile; having a profile does not guarantee a populated list.

Hiddify profile import task card: add profile, refresh, choose proxy, and verify connection
Task order: add the profile, wait for refresh, choose a proxy, and verify with the affected app.

Interface steps

Import a Hiddify Profile and Complete the First Connection

  1. 01

    Prepare the Complete Profile URL

    Copy the complete profile URL. Do not expose token-like values in public pages, screenshots, or support requests.

  2. 02

    Open the Add-Profile Sheet

    Choose Add profile from the dashboard. Read the complete URL from the clipboard or continue to manual entry. Before submitting, confirm that messaging software did not truncate it or add spaces. Wait for the profile name and update time afterward. If neither appears, preserve the message and recheck the URL instead of creating duplicate profiles.

    Hiddify add-profile sheet with Clipboard and Manually actions
    Add a profile from the clipboard or enter it manually.

    How to confirm: Clipboard and manual options are visible.

  3. 03

    Paste the URL Manually

    For manual entry, paste the complete URL and confirm. The address in this screenshot is redacted.

    Hiddify manual profile form annotated with Name, profile URL, and Add steps
    Enter a name, paste the complete profile URL, and choose Add; the sensitive URL remains redacted.

    Check the result: A new profile appears on the dashboard.

    Recovery: If no profile appears, recheck whether the complete URL was truncated or padded with spaces and submit it only once more; do not change routing mode first. Preserve the Add profile error and network state if it still fails, then confirm the address status. Duplicate imports create confusing records and do not repair the original failure.

  4. 04

    Confirm the Profile Appears

    After the profile name appears, open the proxy list from the current-proxy area. If the profile is missing, return to import. When the name exists but the update time does not change, refresh once. If refresh succeeds but the list remains empty, preserve that result and enter Missing Proxies instead of enabling TUN.

    Hiddify dashboard with a loaded profile and Tap to connect state
    The profile is present and the app is ready to start a connection.
  5. 05

    Open the Proxy Selector

    Select the current proxy area to open the list. The red arrow marks the target control.

    Hiddify dashboard with an arrow marking the current proxy entry
    Open the proxy list from the current-proxy area on the dashboard.

    After this step: The proxy list opens.

  6. 06

    Choose One Proxy

    Choose one responsive proxy and return to the dashboard. Do not change the proxy, mode, and DNS together. Keep that proxy selected during the first connection and load a real page in the affected app. If every proxy times out, preserve the list state and enter connection troubleshooting rather than importing the profile again.

    Hiddify Proxies page showing selectable proxies and latency
    Choose a responsive proxy, then return to the dashboard to connect.

    What success looks like: The selected proxy appears on the dashboard.

  7. 07

    Connect and Verify Real Access

    Start the connection, wait for a stable state, and confirm that the selected proxy did not change, then load a real page in the target browser or app. Connected is an intermediate signal. Finish only when the request succeeds and disconnecting restores the previous network path. On failure, restore the original mode and carry the fixed proxy plus error into connection troubleshooting.

    Hiddify dashboard showing Connected status, latency, and the selected proxy
    The app reports a connected state; verify real access in the target browser or app next.

    How to confirm: The dashboard remains connected and the affected app completes a real access test.

    Recovery: On failure, disconnect, restore the prior mode, and open connection troubleshooting.

No Profile, No Proxies, or No Connection After Import

  • No profile name on the dashboard

    Return to Add Profile and confirm the URL was not truncated. Preserve the visible message if manual entry still creates no profile.

    Check the Hiddify profile and proxy list

  • The profile exists but the proxy list is empty

    Check the last refresh time and result; a refresh error and a successful but empty profile require different branches.

    Troubleshoot missing Hiddify proxies

  • A proxy is selectable but the affected app cannot connect

    Keep the current proxy and check connection state, system-proxy coverage, and DNS one at a time.

    Troubleshoot a failed Hiddify connection

Choose System Proxy or TUN After the App Works

Keep System Proxy when browser access works. Evaluate TUN only when the affected app clearly bypasses the system proxy, and record the current settings first.

Set the Hiddify system proxyEnable Hiddify TUN when needed

Profile Import Questions

Why are there no proxies after import?

Check whether the profile exists and whether its update time changed. Re-import a missing profile; refresh an existing one, then reopen the proxy list. If the update succeeds but the list is empty, confirm that the correct profile is active and preserve the result for the provider. TUN and routing mode cannot create missing proxies.

Fix missing proxies

Can I post my subscription URL when asking for help?

Do not publish the complete subscription URL. Share the redacted error, platform, Hiddify version, whether the profile appeared, its update time, and the proxy-list state. Those facts are enough to choose a recovery branch. If the address has already been exposed, ask the provider to replace it rather than continuing to use it.

Hiddify says connected, but the browser has no access. What next?

A successful import only proves that profile data loaded. Keep one proxy and test page fixed while checking connection state, routing mode, System Proxy, and a fully restarted browser. Change one item at a time. If access still fails, restore the original mode and open connection troubleshooting rather than importing duplicate profiles.

Start connection troubleshooting