Skip to content

Commit 4c3c328

Browse files
committed
Updates to 10xxx page
1 parent 6586d9b commit 4c3c328

File tree

1 file changed

+39
-94
lines changed

1 file changed

+39
-94
lines changed

src/content/docs/support/troubleshooting/cloudflare-errors/troubleshooting-cloudflare-10xxx-errors.mdx

Lines changed: 39 additions & 94 deletions
Original file line numberDiff line numberDiff line change
@@ -7,26 +7,26 @@ title: Troubleshooting Cloudflare 10XXX errors
77

88
## Error 10028: The add list items operation contains duplicate items
99

10-
This error occurs when there are duplicate list items in a single operation to add items to a List (either an IP list or a Bulk Redirect List).
10+
This error indicates that the operation to add items to a list contains duplicate entries within the same request.
1111

1212
### Common causes
1313

14-
Possible causes of this error are:
14+
This error occurs when there are duplicate list items in a single operation to add items to a List (either an IP list or a Bulk Redirect List). This error can happen when you:
1515

16-
- Add a repeated IP address to an IP list.
17-
- Add a repeated source URL to a Bulk Redirect List.
16+
- Add a repeated IP address to an IP list
17+
- Add a repeated source URL to a Bulk Redirect List
1818

1919
### Resolution
2020

2121
You need to remove the duplicate item and try again.
2222

2323
## Error 10043: Source URL in redirect is too long
2424

25-
This error occurs when the source URL value of a URL redirect is too long. The maximum length of a source URL is 32,768 characters.
25+
This error indicates that the source URL in a redirect exceeds the maximum allowed length.
2626

2727
### Common causes
2828

29-
Possible causes of this error are:
29+
This error occurs when the source URL value of a URL redirect is too long. The maximum length of a source URL is 32,768 characters. Possible causes of this error are:
3030

3131
- Dynamic URLs that contain excessive query parameters or tracking codes.
3232
- Unnecessary path segments or redundant subdirectories in the URL.
@@ -37,11 +37,11 @@ You need to use a shorter URL as the source URL.
3737

3838
## Error 10044: Target URL in redirect is too long
3939

40-
This error occurs when the target URL value of a URL redirect is too long. The maximum length of a target URL is 32,768 characters.
40+
This error indicates that the target URL in a redirect exceeds the maximum allowed length.
4141

4242
### Common causes
4343

44-
Possible causes of this error are:
44+
This error occurs when the target URL value of a URL redirect is too long. The maximum length of a target URL is 32,768 characters. Possible causes of this error are:
4545

4646
- Dynamic URLs that contain excessive query parameters or tracking codes.
4747
- Unnecessary path segments or redundant subdirectories in the URL.
@@ -52,187 +52,143 @@ You need to use a shorter URL as the target URL.
5252

5353
## Error 10045: Invalid redirect source URL
5454

55-
This error indicates that the source URL provided for a URL redirect is not valid, preventing the redirect from functioning properly.
55+
This error indicates that the source URL for a redirect is not valid.
5656

5757
### Common causes
5858

59-
Possible causes of this error are:
60-
61-
- Contains invalid characters or formatting.
62-
- Is missing essential components, such as the scheme (for instance, `http` or `https`).
59+
This error occurs when the source URL provided for a URL redirect is not valid, preventing the redirect from functioning properly due to missing components, such as the scheme (for instance, `http` or `https`) or improper formatting.
6360

6461
### Resolution
6562

6663
You need to specify a valid URL as the source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
6764

6865
## Error 10046: Invalid redirect target URL
6966

70-
This error indicates that the target URL provided for a URL redirect is not valid, preventing the redirect from functioning properly.
67+
This error indicates that the target URL provided for a URL redirect is not valid.
7168

7269
### Common causes
7370

74-
Possible causes of this error are:
75-
76-
- Contains invalid characters or formatting.
77-
- Is missing essential components, such as the scheme (for instance, `http` or `https`).
71+
This error occurs when the target URL provided for a URL redirect is not valid, preventing the redirect from functioning properly due to missing components, such as the scheme (for instance, `http` or `https`) or improper formatting.
7872

7973
### Resolution
8074

8175
You need to specify a valid URL as the target URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect target URLs.
8276

8377
## Error 10047: Invalid redirect status code
8478

85-
This error occurs when you specify a URL redirect status code that is not supported. 
79+
This error indicates that an unsupported or incorrectly formatted status code was specified for the URL redirect.
8680

8781
### Common causes
8882

89-
Possible causes of this error are:
90-
91-
- You enter a typo or invalid number for the status code.
92-
- You use an unsupported or deprecated status code.
83+
This error occurs when you specify a URL redirect status code that is not supported, typically due to entering an invalid number or using an unsupported or deprecated status code.
9384

9485
### Resolution
9586

9687
Use one of the supported status codes in the URL redirect: `301`, `302`, `307`, or `308`.
9788

9889
## Error 10048: Preserve path suffix requires subpath matching enabled
9990

100-
This error occurs when you enable the **Preserve path suffix** option in a redirect without enabling the **Subpath matching** option. The **Preserve path suffix** option of a URL redirect is only applicable when the **Subpath matching** option is also enabled.
91+
This error indicates a configuration mismatch where the **Preserve path suffix** option is used without enabling **Subpath matching** in a URL redirect.
10192

10293
### Common causes
10394

104-
Possible causes of this error are:
105-
106-
- You forget to enable **Subpath matching** when configuring a redirect with **Preserve path suffix**.
107-
- A configuration change is made without updating the associated options for the redirect.
95+
This error occurs when you enable the **Preserve path suffix** option in a redirect without enabling the **Subpath matching** option. The **Preserve path suffix** option of a URL redirect is only applicable when the **Subpath matching** option is also enabled.
10896

10997
### Resolution
11098

11199
Enable **Subpath matching** for the URL redirect with **Preserve path suffix** enabled.
112100

113101
## Error 10049: Invalid scheme in redirect source URL
114102

115-
This error occurs when the source URL of a URL redirect has an invalid scheme.
103+
This error indicates that the source URL's scheme is invalid.
116104

117105
### Common causes
118106

119-
Possible causes of this error are:
120-
121-
- The source URL uses a misspelled or unsupported scheme.
122-
- The scheme is missing or improperly formatted.
107+
This error occurs when the source URL of a URL redirect has an invalid scheme, which may be due to a misspelled or unsupported scheme or because the scheme is missing or improperly formatted.
123108

124109
### Resolution
125110

126111
Review the source URL and ensure that it uses one of the supported schemes: `http`, `https`, or empty (no scheme information, which means that it applies to both schemes). Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
127112

128113
## Error 10050: Invalid redirect source URL with user info
129114

130-
This error occurs when the source URL of a URL redirect includes a user info component (for example, `https://user:[email protected]`), which is not supported.
115+
This error indicates that the source URL includes unsupported user information.
131116

132117
### Common causes
133118

134-
Possible causes of this error are:
135-
136-
- The source URL mistakenly includes user credentials.
137-
- A copy-pasted URL from another source contains embedded user information.
119+
This error occurs when the source URL of a URL redirect includes a user info component (for example, `https://user:[email protected]`), which is not supported.
138120

139121
### Resolution
140122

141123
You need to remove the user information component from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
142124

143-
***
144-
145125
## Error 10051: Missing authority in redirect source URL
146126

147-
This error occurs when the source URL of a URL redirect does not include an authority component (for example, `http:///path`, without a hostname), which is mandatory.
127+
This error indicates that the source URL is missing a required authority component.
148128

149129
### Common causes
150130

151-
Possible causes of this error are:
152-
153-
- The source URL is missing the hostname or authority component (e.g., http:///path instead of http://example.com/path).
154-
- A typo or formatting error results in an incomplete URL.
131+
This error occurs when the source URL of a URL redirect does not include an authority component (for example, `http:///path`, without a hostname), which is mandatory.
155132

156133
### Resolution
157134

158135
Add an authority component to the redirect source URL (for example, include a hostname). Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the required URL components for redirect source URLs.
159136

160137
## Error 10052: Invalid redirect source URL with port
161138

162-
This error occurs when the source URL of a URL redirect includes a port (for example, `https://example.com:8081`), which is not supported.
139+
This error indicates that the source URL includes an unsupported port.
163140

164141
### Common causes
165142

166-
Possible causes of this error are:
167-
168-
- The source URL is configured to include a custom or non-standard port.
169-
- A copy-pasted URL from another environment or system includes a port.
170-
- A development or testing URL was mistakenly used in the redirect configuration.
143+
This error occurs when the source URL of a URL redirect includes a port (for example, `https://example.com:8081`), which is not supported. Possible causes include using a custom or non-standard port, copying a URL from another environment that includes a port, or mistakenly using a development or testing URL.
171144

172145
### Resolution
173146

174147
Remove the port from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
175148

176149
## Error 10053: Invalid redirect source URL with query string
177150

178-
This error occurs when the source URL of a URL redirect includes a query string component, which is not supported.
151+
This error indicates that the source URL contains an unsupported query string component.
179152

180153
### Common causes
181154

182-
Possible causes of this error are:
183-
184-
- The source URL is copied from a browser or external source that includes query parameters (for example, https://example.com/page?param=value).
185-
- Misconfiguration or oversight during the URL setup includes unnecessary query strings.
186-
- An attempt to redirect based on specific query parameters rather than the path alone.
155+
This error occurs when the source URL of a URL redirect includes a query string component, which is not supported. Possible causes include copying a URL with query parameters, misconfiguration during setup, or attempting to redirect based on query parameters instead of the path.
187156

188157
### Resolution
189158

190159
Remove the query string from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
191160

192161
## Error 10054: Invalid redirect source URL with fragment
193162

194-
This error occurs when the source URL of a URL redirect includes a fragment component (for example, `https://example.com/search/#fragment`). Fragment components are not part of an HTTP request; they are an indication for the browser to scroll to a specific location once the page has loaded.
163+
This error indicates that the source URL includes an unsupported fragment component.
195164

196165
### Common causes
197166

198-
Possible causes of this error are:
199-
200-
- The source URL is copied from a browser or external source that includes a fragment (for example, #section1).
201-
- A fragment was inadvertently added during URL configuration or editing.
167+
This error occurs when the source URL of a URL redirect includes a fragment component (for example, `https://example.com/search/#fragment`). Fragment components are not part of an HTTP request; they are an indication for the browser to scroll to a specific location once the page has loaded. Possible causes of this error include copying a URL with a fragment from a browser or external source, or inadvertently adding a fragment during URL configuration or editing.
202168

203169
### Resolution
204170

205171
Remove the fragment from the redirect source URL. Refer to [Supported URL components in Bulk Redirects](/rules/url-forwarding/bulk-redirects/reference/url-components/) for details on the supported URL components for redirect source URLs.
206172

207173
## Error 10055: Query string settings incompatible with redirect target URL
208174

209-
This error occurs when you enable the **Preserve query string** option of a URL redirect, but also provide a query string in the redirect target URL. In this case, the URL redirect would have conflicting configuration on how to handle the query string of incoming requests.
175+
This error indicates a conflict between the **Preserve query string** option and the query string in the redirect target URL.
210176

211177
### Common causes
212178

213-
Possible causes of this error are:
214-
215-
- The **Preserve query string** option is enabled without consideration of the target URL's existing query string.
216-
- A query string was added to the target URL after the redirect configuration was created.
179+
This error occurs when you enable the **Preserve query string** option of a URL redirect, but also provide a query string in the redirect target URL. In this case, the URL redirect would have conflicting configuration on how to handle the query string of incoming requests.
217180

218181
### Resolution
219182

220-
Perform one of the following:
221-
222-
- Disable the **Preserve query string** option in the URL redirect
223-
- Remove the query string component from the redirect target URL
183+
To resolve this issue, either disable the **Preserve query string** option in the URL redirect or remove the query string component from the redirect target URL to eliminate the conflict.
224184

225185
## Error 10056: The add list items operation contains different types of list items
226186

227-
This error occurs when there are different types of list items (for example, IP addresses, hostnames, and URL redirects) in a single operation to add items to a list. The error may occur for an IP list, a hostname list, or a Bulk Redirect List.
187+
This error indicates that different types of list items were combined in a single add operation.
228188

229189
### Common causes
230190

231-
Possible causes of this error are:
232-
233-
- Mixing different types of items (for example, IP addresses and URL redirects) in a single add operation.
234-
- Copying and pasting list items without verifying that they match the intended list type.
235-
- Misconfiguration or oversight when creating or updating the list.
191+
This error occurs when different types of list items (such as IP addresses, hostnames, and URL redirects) are included in a single operation to add items to a list. It can occur with an IP list, a hostname list, or a Bulk Redirect List.
236192

237193
### Resolution
238194

@@ -243,15 +199,11 @@ Remove the list items that do not apply to the list type. This means:
243199

244200
## Error 10058: List items incompatible with list type
245201

246-
This error occurs when you are adding items to a list (either IP list, hostname list, or Bulk Redirect List) and the list items are incompatible with the list type.
202+
This error indicates that incompatible items were added to the wrong list type.
247203

248204
### Common causes
249205

250-
Possible causes of this error are:
251-
252-
- Attempting to add IP addresses to a hostname or Bulk Redirect List.
253-
- Adding URL redirects to an IP list or hostname list.
254-
- Misconfiguration or confusion regarding the intended list type.
206+
This error occurs when you are adding items to a list (either IP list, hostname list, or Bulk Redirect List) and the list items are incompatible with the list type.
255207

256208
### Resolution
257209

@@ -263,30 +215,23 @@ Make sure you are adding the items to the correct list:
263215

264216
## Error 10059: Maximum number of repeated URL source paths exceeded
265217

266-
This error occurs when you have more than the maximum number of URL redirects with the same source URL path across all Bulk Redirect Lists in your account, regardless of the URL redirect domain.
218+
This error indicates that the same URL path is repeated too many times across your Bulk Redirect Lists.
267219

268220
### Common causes
269221

270-
Possible causes of this error are:
271-
272-
- Multiple Bulk Redirect Lists contain redirects with the same source URL path.
273-
- Overlapping or duplicate configurations across different lists and domains.
274-
- Mismanagement of redirects, leading to excessive duplication of source URL paths.
222+
This error occurs when you have more than the maximum number of URL redirects with the same source URL path across all Bulk Redirect Lists in your account, regardless of the URL redirect domain. Possible causes include multiple lists containing the same redirects, overlapping configurations, or mismanagement resulting in duplicated source URL paths.
275223

276224
### Resolution
277225

278226
Review the path of your source URLs so that you do not have more than the maximum number of URL redirects sharing the same URL path in your account, regardless of their domain or the list they belong to. Refer to [URL redirect parameters](/rules/url-forwarding/bulk-redirects/reference/parameters/) for more information on the current limits.
279227

280228
## Error 10060: Missing scheme in redirect target URL
281229

282-
This error occurs when the target URL of a URL redirect does not include a scheme, which is mandatory.
230+
This error indicates that the target URL is missing a scheme.
283231

284232
### Common causes
285233

286-
Possible causes of this error are:
287-
288-
- The target URL is missing the http or https scheme due to a typo.
289-
- The URL was copied from a source that did not include the scheme.
234+
This error occurs when the target URL of a URL redirect does not include a scheme, which is mandatory. This could have happened due to a typo or the URL was copied from a source that did not include the scheme.
290235

291236
### Resolution
292237

0 commit comments

Comments
 (0)