GoshLinks
Back to all documentation
Back to Importing & Exporting Data

Documentation

Importing from a YOURLS Installation on the same site

Import links directly from a YOURLS installation that is available on the same server.

Import from YOURLS installed on this website- Step by Step

Use this tool to import links and optional click data from a YOURLS installation into GoshLinks.

Before you start: You will need direct access to your YOURLS database (via cPanel, hosting provider, or similar). Your YOURLS install must be on THIS server.

Step 1 - Enter YOURLS Database Details

Fill in the following fields exactly as they appear in your YOURLS setup:

  • Database Host - Usually localhost.
  • Database Name - Your YOURLS database name.
  • Database Username - Your database username.
  • Database Password - Your database password.
  • Table Prefix - Usually yourls_ unless changed during installation.

Step 2 - Choose Link Import Option

Select one of the following options under Links:

  • Delete all existing links and their click data before importing
    Completely replaces all current links in GoshLinks with your YOURLS links. All current links and their click data will be lost.
  • Keep existing links, only import new, unique YOURLS links
    Skips any link where the slug already exists. Here you are basically adding any new links found in your YOULS database.
  • Keep existing unique links, but import all YOURLS links
    Overwrites existing links that have the same slug as in the YOURLS database. Existing link that have a slug not in your YOULRS database will remain untouched.

Step 3 - Choose Whether to Import Click Data

Select how click data should be handled under Data:

  • Import click data for any new link being imported
  • When overwriting existing links, replace click data for those overwritten links as well

Step 4 - Click "Start Import"

  • Click the Start Import button to begin.
  • The plugin will attempt to connect to your YOURLS database using the details provided.
  • Links will be imported from the YOURLS URL table.
  • If selected, click data will be imported from the YOURLS log table.

Step 5 - Review the Results

  • A summary will show how many links were imported, skipped, or overwritten.
  • Check your links on the All Links or Bulk Editing page.

Common Issues

  • Connection failed - Incorrect database host, username, password, or prefix.
  • No links found - Wrong table prefix or incorrect database selected.
  • Click data missing - YOURLS log table may be empty or not available.