> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/import-data/import-concepts/channable-ip-addresses-and-user-agents/troubleshoot-blocked-imports-and-connections.md).

# Troubleshoot blocked imports and connections

Learn how to troubleshoot server blocks affecting imports, image downloads, order connections, and SFTP exports.

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You'll need**

* A server administrator who can check server logs and update the allowlist.

**Good to know**

* Allowlisting (whitelisting) doesn't fix most import errors. Your team must update the allowlist when Channable's addresses change.

***

### Troubleshoot blocked imports

If your import has been stuck for some time, it may be due to an access issue.&#x20;

{% stepper %}
{% step %}

#### Check the import URL

Open the import URL in your browser.

If the page doesn't load or shows an error, fix the URL or file on your server. Channable can't import a URL that doesn't work in a browser.
{% endstep %}

{% step %}

#### Check your server logs

Check for one of these errors:

* `403` or `Access forbidden`: The server received the request and refused it.
* `Timeout` or `Connection refused`: A firewall dropped the request before it reached the server.

{% hint style="info" %}
For other errors, allowlisting IP addresses won't resolve the issue. [Contact Support](https://helpcenter.channable.com/get-started/contact-support.md) with a screenshot of your server error logs.&#x20;
{% endhint %}
{% endstep %}

{% step %}

#### Ask your administrator to update the allowlist

Copy and send your server administrator [Channable's IP addresses](https://helpcenter.channable.com/import-data/import-concepts/channable-ip-addresses-and-user-agents.md) and ask them to allow all addresses on the port your import URL uses.
{% endstep %}

{% step %}

#### Run the import again

After your administrator confirms the change, run the import again.

If the import still fails, [contact Support](https://helpcenter.channable.com/get-started/contact-support.md) with a screenshot of your server error logs.
{% endstep %}
{% endstepper %}

### Troubleshoot blocked image downloads

If the Image Editor isn't retrieving images, the image server might be blocking Channable's image downloader.

{% stepper %}
{% step %}

#### Allow the image downloader user agent

Ask your server administrator to [allow Channable's image downloader user agent](https://helpcenter.channable.com/import-data/import-concepts/channable-ip-addresses-and-user-agents.md#user-agent).&#x20;
{% endstep %}

{% step %}

#### Contact Support if user agent allowlisting isn't possible

[Contact Support](https://helpcenter.channable.com/get-started/contact-support.md) if the server can't allowlist by user agent to confirm whether you need to allowlist IP addresses instead.
{% endstep %}
{% endstepper %}

### Order connections and SFTP exports

Order connections and SFTP exports rarely need allowlisting.&#x20;

If the receiving server blocks Channable, ask your server administrator to allow [Channable's IP addresses](https://helpcenter.channable.com/import-data/import-concepts/channable-ip-addresses-and-user-agents.md), then retry the connection.

{% hint style="info" %}

#### Crawler imports <a href="#crawler-imports" id="crawler-imports"></a>

Allowlisting doesn't work for crawler imports. Channable crawlers run on third-party infrastructure, so there is no fixed list of addresses to allow. A page that loads in your browser can still block the crawler.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/import-data/import-concepts/channable-ip-addresses-and-user-agents/troubleshoot-blocked-imports-and-connections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
