Documentation

Importing from a YOURLS Installation on the same site

GoshLinks Pro can import from a YOURLS database on the same server or site environment.

GoshLinks Pro can import from a YOURLS database on the same server or site environment.

Use this option when YOURLS data is available from the same WordPress install or hosting account and you can access the YOURLS database details.

Before You Start

You need access to the YOURLS database details.

You will need:

  • YOURLS DB Host
  • YOURLS DB Name
  • YOURLS DB User
  • YOURLS DB Password
  • YOURLS Links Table
  • YOURLS Log Table, if importing click data

Step 1: Open YOURLS Import

  1. Go to GoshLinks > Settings > Import.
  2. Open the YOURLS Import accordion.
  3. Choose that YOURLS is installed on this site.

Step 2: Enter Database Details

Enter the database details exactly as they are configured for YOURLS.

The default table names are usually:

  • yourls_url for links.
  • yourls_log for click data.

Step 3: Choose Link Import Mode

Choose whether to replace all links, only import new unique links, or overwrite matching slugs.

If the site already has GoshLinks links, the safest option is usually to keep existing links and only import new unique links.

Step 4: Choose Click Data Options

If you want historical YOURLS click data, select the click data options and make sure the log table name is entered.

YOURLS click rows are imported as click activity.

Step 5: Choose QR Code Creation

If QR code creation is enabled in GoshLinks, the YOURLS import can show an option to create QR codes for the imported links.

YOURLS does not provide QR codes, QR scan data, or GoshLinks custom QR settings, so imported YOURLS links use the default GoshLinks QR branding when QR codes are created.

The generated QR codes are new GoshLinks QR codes and point to the new GoshLinks short URLs.

Step 6: Run the Import

Click Run YOURLS Import.

GoshLinks checks the YOURLS tables and imports in batches where needed.

Tip

Run a GoshLinks export before importing from YOURLS if the site already has important links or stats.

Also make sure your GoshLinks base path does not conflict with an existing live YOURLS base path or redirect setup. If both systems try to handle the same short URL path, one system may intercept traffic before the other can track it.