Skip to main content

Upload Sitemap

What is the Upload Sitemap page?​

The Upload Sitemap page is where you can import the pages of your website that you want to analyze. You can upload a CSV or XML file containing the list of URLs from your site, and Axessibly will automatically organize them in the sitemap for scans.

How to get started?​

When you access the Upload Sitemap page, you see an area where you can drag a file or click to select it. Before uploading, you can also download a template to see the correct format.

Supported Formats​

Axessibly supports two file formats for sitemaps:

CSV (Comma Separated Values)​

The CSV format is simple and easy to create. You can use Excel, Google Sheets, or any text editor.

Two types of CSV are supported:

  1. Simple URL list: Just one column with URLs, one per line. This format is available to all users (Demo, Pro, Enterprise).

  2. Complete CSV with metadata: Includes columns for URL, title, priority, update frequency, and last modification date. This format is only available to Pro and Enterprise users.

XML (Standard Sitemap)​

The XML format is the standard for web sitemaps. If your site already has an XML sitemap (like sitemap.xml), you can upload it directly.

Note: Uploading XML files is only available to Pro and Enterprise users.

Available Templates​

Before creating your file, you can download a template to see the correct format. There are three templates available:

Simple URL List (CSV)​

This template shows how to create a CSV file with just a list of URLs. It's the simplest format and suitable if you only need to list pages to scan.

Format:

URL
https://example.com
https://example.com/about
https://example.com/contact

Complete Template (CSV)​

This template shows how to create a CSV file with all additional information: URL, title, priority, update frequency, and last modification date.

Format:

url,title,priority,changefreq,lastmod
https://example.com,Homepage,1.0,daily,2024-01-01
https://example.com/about,About Us,0.8,monthly,2024-01-01

Available columns:

  • url: The complete address of the page (required)
  • title: The page title (optional)
  • priority: Page priority from 0.0 to 1.0 (optional, default: 0.5)
  • changefreq: Update frequency (optional, e.g.: daily, weekly, monthly)
  • lastmod: Last modification date (optional)

Standard XML Sitemap​

This template shows the standard XML format for web sitemaps. It's the format that many websites already use.

Note: This template is only available to Pro and Enterprise users.

How to Upload a File​

There are two ways to upload a file:

Drag & Drop​

  1. Open the folder on your computer where the file is located
  2. Drag the file to the upload area on the page
  3. Release the file when you see the highlighted area
  4. The file will be uploaded automatically

Click to Select​

  1. Click on the upload area or the "Select file" button
  2. A window will open to select the file
  3. Choose the CSV or XML file from your computer
  4. Click "Open" or "Select"
  5. The file will be uploaded automatically

Validation and Checks​

When you upload a file, Axessibly automatically performs several checks:

Format Check​

The system verifies that the file is a valid CSV or XML. If the format is not correct, you'll see an error message.

URL Validation​

Each URL in the file is checked to ensure it's valid. URLs must:

  • Start with http:// or https://
  • Be complete and valid URLs
  • Not contain spaces or invalid characters

If a URL is not valid, you'll see an error message indicating which row has the problem.

Content Check​

The system verifies that the file contains at least one valid URL. If the file is empty or doesn't contain valid URLs, you'll see an error message.

Data Preview​

After successfully uploading a file, you'll see a preview of the loaded data. The preview shows:

  • Total number of URLs: How many pages have been loaded
  • First pages: The first URLs loaded with their details (if available)
  • File type: Whether a CSV or XML was uploaded

If there are more URLs than those shown in the preview, you'll see a message indicating how many other URLs there are.

What Happens After Upload​

After successfully uploading a file:

  1. Automatic saving: All URLs are automatically saved to the sitemap
  2. Initial state: All URLs are set as "enabled" and "never scanned"
  3. Ready for scans: You can go to the Sitemap Management page to start scanning pages

Note: If you already have URLs in the sitemap, new URLs will be added to existing ones. They won't be overwritten.

Error Handling​

If something goes wrong during upload, you'll see an error message explaining what happened. Here are some common errors and how to fix them:

Invalid file​

Error: "Please select a valid CSV or XML file"

Solution: Make sure the file has the .csv or .xml extension and is a valid file.

Missing or invalid URL​

Error: "Missing URL at row X" or "Invalid URL at row X"

Solution: Check the file and make sure each row has a valid URL. URLs must start with http:// or https://.

Invalid XML file​

Error: "Invalid or malformed XML file"

Solution: Make sure the XML file is well-formed and follows the XML sitemap standard. You can use the XML template to see the correct format.

File too large​

Error: The file exceeds the maximum size

Solution: The maximum size is 10MB. If your file is larger, consider splitting it into multiple smaller files.

Insufficient permissions​

Error: "XML file upload is only available for PRO or higher users"

Solution: To upload XML files or CSV files with metadata, you need a Pro or Enterprise account. Demo users can only upload simple URL lists in CSV format.

Useful Tips​

  1. Use templates: Before creating your file, download a template to see the correct format. This will help you avoid errors.

  2. For existing sitemaps: If your site already has an XML sitemap, you can upload it directly. You don't need to convert it to CSV.

  3. Simple list to start: If it's your first time, start with a simple URL list. You can always add metadata later.

  4. Verify URLs: Before uploading, make sure all URLs are valid and accessible. Invalid URLs will be reported as errors.

  5. Organize by priority: If you use the complete format, you can organize pages by priority. The most important pages should have higher priority (close to 1.0).

  6. Make backups: Before uploading a new file, consider backing up the existing sitemap from the Sitemap Management page.

Required Permissions​

Some features require specific accounts:

  • Simple CSV upload: All users (Demo, Pro, Enterprise) can upload simple URL lists
  • Complete CSV upload: Only Pro and Enterprise can upload CSV with metadata (titles, priority, etc.)
  • XML upload: Only Pro and Enterprise can upload XML files

Demo users can only upload simple URL lists in CSV format.

After Upload​

After successfully uploading the sitemap:

  1. Go to the Sitemap Management page to see all loaded URLs
  2. You can enable or disable specific URLs
  3. You can start scanning pages individually or in batch
  4. You can see the status of each scan

The uploaded sitemap is now ready to be used for accessibility scans!