Adding APs in Bulk

RUCKUS One provides a bulk import function, allowing you to add multiple access points (APs) to RUCKUS One using a single, downloadable CSV template file.

Note: The import file must be in CSV format, contain no more than 10,000 APs, include a maximum of 100 venue allocations (the venues must already exist in the system), and be no larger than 5 MB.
Refer to Standards for Importing a CSV File for information about CSV formatting, validation rules, and import requirements.
Complete the following steps to import and add multiple APs to your RUCKUS One account.
  1. On the navigation bar, select Wi-Fi > Access Points > AP List.
    The Access Points page is displayed.
  2. In the upper-right corner, click Add and then click Import APs.
    The Import from file sidebar is displayed.
  3. (Recommended) Click Download CSV Template to download the CSV template to your local machine.
    Import from file - Download CSV Template
  4. Open the downloaded template file on your local device, enter the following details and save the file.
    Note: You can edit the CSV file using Google Sheets, Microsoft Excel, or Apple Numbers.
    Note: Refer to the topic Rules for Required and Optional CSV Fields for more information.
    1. AP Name: Enter the name to be assigned to the AP.
    2. (Optional) Description: Enter a short description to be assigned to the AP.
    3. Serial Number: Enter the serial number of the AP.
    4. Venue: Enter the venue name.
    5. (Optional) AP Group: Enter the AP group name.
    6. (Optional) Tags: Enter one or more AP tags.
    7. (Optional) Latitude: Enter the latitude coordinate ranging between -90 to 90 degrees.
    8. (Optional) Longitude: Enter the longitude coordinate ranging between -180 to 180 degrees.
    9. (Optional) Global Untagged VLAN ID: Allows you to define a VLAN ID that is automatically applied to all downstream access ports when an access point connects to the cloud. This ensures consistent VLAN tagging across the network without requiring manual configuration for each port.
  5. In the Import from file sidebar, drag-and-drop the CSV file into the upload area, or click Browse to select the file.
    You can replace the file by clicking the Change File button, which allows you to browse and upload a new file.
  6. Click Start Import.
    The Import from file sidebar closes automatically and an in-progress toast notification appears at the bottom-right corner, displaying the total AP count, the live completion percentage, and a Details link that launches the Activity Details sidebar.
    Note:
    • Do not rename, delete, or change permissions of the target Venue or AP Group while the import is in progress, as this may cause APs to be skipped or incorrectly configured.
    • Invalid rows are skipped and valid rows continue importing.
  7. Click the Details link to view the Activity Details sidebar.
    Note: The toast notification remains on the screen until all import activities are complete.
    Activity Details Sidebar - Imports In-Progress

    The Activity Details sidebar continuously refreshes, displaying the following information:

    • The sidebar displays the Start Time, End Time, Severity, Event Type, Source (the user who performed the import), and Description. While in-progress, the description shows the number of APs being imported and the overall completion percentage. After all import activities are completed, the description displays the final numbers of successful and failed AP imports, and includes the Download Error Report link if failures occurred.
    • Success: Displays a green panel showing how many APs were imported successfully.
    • Failed: Displays a red panel showing how many APs were not imported.
    • In Progress: Displays a gray panel showing how many APs are still processing.
    • Target Venue: Displays import results for each venue included in the CSV file. Venue names appear as clickable links if they are accessible to you.
      Note: The venue name displayed on the Activity Details page is taken from the uploaded CSV file and does not reflect any venue name changes made after the import starts.
    • # of Devices: Displays the number of APs associated with the venue.
    • Status: Indicates the outcome or progress of AP import tasks for each venue. Status includes Success, Failed, Partial Success, In Progress, and Pending.
    • Description: Displays a brief explanation when the target venue has a single error. When multiple records have validation errors, it summarizes the number of successful and failed imports instead of listing individual error messages.
    • Current Status: Indicates the system-level status of the bulk AP import operation.
    • Processing Timeline: Displays the sequence and status of system operations involved in completing the bulk AP import. It includes timestamps for each step, indicates statuses like In Progress, Success, Partial Success, or Failed.
      Activity Details - Import Operation Completed
  8. (Optional) You can download the success report by clicking the icon on the Success panel. Similarly, you can download the error report by clicking the Download Error Report link in the Description field or the icon on the Failed panel.
    The report file is downloaded to your local system. Review the error report, fix the failed entries in the CSV file, and re-import it to complete the process.
    Note: The reports are also available for download in Administration > Timeline > Activities.