Skip to main content
How Can We Help?
< All Topics
Print

SwapAds Backlinks Shortcode & Block — Display Guide

Posted
Updated
BySwapAds

Approved partner backlinks are displayed through the SwapAds block or shortcode — the plugin never injects links into your content on its own.

The Gutenberg block

Search for the SwapAds Backlinks block in the block editor and add it to any page, post, or widget area. The block supports:

  • Count — how many backlinks to render (1–50, default 5).
  • Mode — list, card, or text layout (default: list).
  • Audience — filter by audience code, such as your niche or a sub-niche code. Leave empty to show all.
  • Category — filter by a substring of a partner’s domain. Leave empty to show all.
  • Random — randomize which backlinks display on each load (default: off).
  • Align — wide or full-width alignment (block only).

The block renders server-side, so visitors receive plain HTML. The only front-end script SwapAds adds is a small click-tracking script that loads on your public pages.

The shortcode

Prefer a shortcode? Use [swapads_backlinks] with the same attributes as the block, except Align:

  • count — number of links to show, 1–50 (default 5).
  • mode — list, card, or text (default: list).
  • audience — audience code to filter by (default: all).
  • category — substring of a partner’s domain to match (default: all).
  • random — true or false (default: false).

Examples:

[swapads_backlinks]
[swapads_backlinks count="10" mode="card" random="true"]
[swapads_backlinks category="example.com"]

Fallback content

Wrap content between the tags to show a fallback when you have no approved backlinks yet:

[swapads_backlinks]No partner links yet — check back soon.[/swapads_backlinks]

Rendered output is cached for up to 60 seconds — after approving or retracting a link, allow a minute before the change appears.

Where to place it

  • A dedicated Partners or Outbound Links page — the most transparent pattern.
  • Your footer widget area — a small, always-visible link block.
  • Relevant in-content sections, e.g. a resources list in a blog post.

Transparent placement (a clearly labeled partners or resources section) reads naturally to visitors and to search engines alike.

Related articles

Table of Contents