Tophatter - Configure Channel Settings

This guide details the settings that can be configured for a Tophatter once it has been added to Linnworks. 

If your API Settings change you can reset your channel with the new details by clicking on the "test" button and following the re-integration wizard.

Table of Contents


To configure your Tophatter channel, it must already be added to Linnworks

Accessing the Screen

Go to Settings > Channel Integration, and click on the Edit Channel button    in-line with your Tophatter Integration

Available Options 


  • Enabled: Tick this option to allow communication between Linnworks and Tophater, without enabling, no information will be sent or received from Tophater such as downloaded orders or inventory level updates. Once enabled, Linnworks will start downloading all orders with Status Unshipped (Shipping in progress) on your Tophatter account.
  • Test: Clicking this button will check that Linnworks can successfully communicate with Tophatter. Remember, if you have changed your Tophatter integration details, and they are now different to the ones used to integrate the channel initially, pressing the Test button will allow you to re-integrate the channel


  • Update Inventory: Allow Linnworks to submit changes in stock level to Tophatter Linnworks supports multiple stock locations for additional warehouses/fulfillment, centres/suppliers. Ensure you set which Linnworks locations are used when submitting changes in stock level to your channel via the Location Mapping screen accessed from the main Channel Integration screen.
  • Price Change: Price Change is designed to speed up the process of updating the sales channel once a Linnworks stock item has had its listing price updated and saved. 
  • Max Listed: This specifies the maximum level that will be sent to the channel
  • Stock Percentage: This will send a percentage of the currently available stock level to the sales channel
  • End When: This enables you to force the listing to end when the stock level gets to the specified amount as opposed to the default value of zero
    • For more details go to the End When guide. 

  Listings is designed to update the listings on the mapping page once every 12 hours, but for any reason, it has not or you require updated listings more regularly, then the Download Listings button here allows you to force the update.

  • Listing Download in Progress: This tick box will automatically toggle on and off when Linnworks is retrieving listings from the channel.
  • Listing Download Start Date Time:: This will show the date and time of when the most recent download started.
  • Last Manual Download: This will show the date and time of when the last manual download was requested.
  • Listing Download Estimated Completion: This will give you an estimate of when the manual download will be complete – the time can vary depending on server speeds and a number of listings.
  • Download Listings: Click on this button to force Linnworks to request an update from the channel for your active listings.


  • Despatch Notes:  If the option is disabled no despatch information will be submitted to Tophatter. When enabling this option after processing an order in Linnworks, a dispatch notification will be submitted to the channel.
    • Order status on Tophatter will be updated to the status Shipped
    • Linnworks will send the Vendor name to Tophatter, therefore you will have to define a proper Vendor name within Shipping Service in Linnworks. Else, Royal Mail will be sent as default
    • Tracking Number, a mandatory field for Tophatter integration, will be sent to the channel along with Shipping Vendor
  • Order sync date [UTC]: This shows the date and time when Linnworks last synchronised with the channel.

  API Settings

  • API Key: API Key that you have obtained during your integration process
  • Default Currency: This is the Country of your Tophatter account

Next Steps

Inventory Mapping
Location Mapping
Payment Mapping
Shipping Mapping