Publisher Setup Guide

How to add homes to swap to your website

A free panel of council and housing association homes to swap, nearest to your readers. Ten minutes, no code needed on WordPress.

The short answer

To add council and housing association homes to swap to your website, install the free UK Council Home Swaps WordPress plugin, or paste one line of code into an HTML or embed block on any other site. The panel shows the homes nearest your readers, keeps itself up to date, sets no cookies and costs nothing. Build your panel and get your code.

Last updated · plugin version 1.0.1 · works with WordPress 5.8 and later

What the homes to swap panel is

Tenants of councils and housing associations can swap homes with each other through mutual exchange. The panel puts live mutual exchange listings on your own website, so a reader who may want to move into or out of your area can see real homes to swap without leaving your page.

  • Nearest first. Homes inside your chosen distance (5 miles unless you change it) come first. If there are only a few, the nearest ones further afield are added under a “Further afield” heading, so the panel is never empty.
  • Always up to date. It reads the live listings. You never edit it.
  • Photos on every card. A home without its own photo shows a photo of the area, tagged “Area photo”.
  • Private. Only what is already public on each home’s page is shown: the photo, title, bedrooms, type, rent and postcode district. Never the street. It sets no cookies and tracks no one.
  • Free. No account, no payment and no contract. Read the Publisher Terms.

What you need before you start

  • A website you can edit. On WordPress you need to be able to install a plugin. Elsewhere you need a place to paste an HTML or embed block.
  • The town, city, village or postcode your readers are in.
  • About ten minutes.

Not sure which route to take? If your site runs on WordPress, use option 1. If it does not, or you would rather not install anything, use option 2. Both show exactly the same panel.

Option 1: set up the WordPress plugin

The UK Council Home Swaps plugin adds the panel as a block, a sidebar widget or a shortcode. It also tells you when a new version is ready.

  1. Download the plugin

    Get the free zip from the publishers page. Keep it as a zip: do not unzip it.

  2. Install and activate it

    In WordPress go to Plugins › Add New › Upload Plugin, choose the zip, press Install Now, then Activate. Installing alone is not enough: it must be activated.

  3. Set your area

    Go to Settings › UK Council Home Swaps. Type your town or postcode, choose the distance and how many homes to show, then Save Changes. These become the defaults for the whole site.

  4. Add the panel to a page

    Choose whichever suits your theme:

    • Block editor: edit the page, press +, search for UK Council Home Swaps and choose it. The options are in the side panel.
    • Sidebar or footer: go to Appearance › Widgets, add UK Council Home Swaps and save.
    • Classic editor or a page builder (such as Elementor or Divi): use a shortcode. Settings › UK Council Home Swaps has a shortcode builder: pick your options, press Copy shortcode and paste it into a shortcode or text block.
  5. Update the page and view it

    Press Update, then View Page. What you should see.

WordPress shortcode options

A shortcode with every option looks like this:

[uk_council_home_swaps location="Worthing" radius="10" count="4" layout="strip" theme="dark"]
OptionWhat it doesAllowed values
locationThe place your readers are in. The nearest homes come first.A town, city or village, or a full postcode. Blank shows the latest homes anywhere in the UK.
radiusHow many miles to look first.1 to 50 (default 5)
countHow many homes to show.1 to 6 (default 3)
layoutThe shape of the panel.side (narrow, for sidebars) or strip (wide, for a page)
themeLight or dark colours.auto (matches the reader’s device), light, dark
accentThe colour of the dot and the “See all homes” button.Six hex digits, for example e8a33d
creditThe small “Powered by” link under the panel.1 to show it, 0 to hide it
keyYour free partner key (optional).Best entered once in the plugin settings

Option 2: one line of code for any website

This works on any website that lets you add an HTML or embed block, including WordPress sites that do not use our plugin.

  1. Build your panel

    On the publishers page choose your town or postcode, the shape, distance, number of homes and colours. A live preview updates as you go.

  2. Copy the code

    Press Copy the code. It is two short lines: a small placeholder and a script that fills it.

  3. Paste it where you want the panel

    Paste it into an HTML, custom HTML or embed code block on the page or sidebar, then publish the page.

If your website only allows frames

Some website builders do not allow a script and only accept a frame (an iframe). The publishers page gives you an iframe version of the same panel. It works the same way, but its height is fixed.

If your site blocks outside content

If your site uses a Content Security Policy, allow www.mutualhomeexchange.co.uk in both script-src and frame-src.

Choosing the place, size and colours

  • Place. Use the town or postcode your readers are in. A postcode is most exact. A town name uses the largest place of that name that has a guide.
  • Distance. 5 miles suits a town. For villages and rural areas try 10 to 25 miles. The panel adds the nearest homes further afield when there are few, so a smaller distance still works.
  • Shape. Choose Sidebar (narrow) for a sidebar or a column beside an article, and Section (wide) for a page or a band across the width of your site.
  • Number of homes. Three suits a sidebar. A wide section shows up to six well.
  • Colours. Match the reader’s device follows light or dark mode. Pick light or dark if you want it fixed, and add your own accent colour to match your brand.
  • Where to put it. Beside a mutual exchange or housing page works best, because readers are already thinking about moving. A local newspaper can add it to a housing, property or community section.

Check that it works

View the page. You should see a panel headed Homes To Swap with up to the number of homes you chose, each with a photo, bedrooms, type, rent and distance. A “See all homes” button and a “Powered by” link sit underneath. Open it on a phone as well: it fits its space.

If you cannot see the panel, scroll to where it should be. It loads when it is close to the screen. Then see fix common problems.

Fix common problems

I see the shortcode text instead of a panel

The plugin is installed but not active. Go to Plugins and press Activate under UK Council Home Swaps.

I can’t find the block

The block only shows in the block editor. On the classic editor or a page builder, use the shortcode from Settings › UK Council Home Swaps instead.

WordPress says “Forbidden” (403) when I save the page

This is your web host’s firewall (often ModSecurity), not the plugin. It can block any page save. Create a new page and try again, ask your host to check the firewall log and allow the rule, or switch ModSecurity off for your domain while you save.

There is empty space where the panel should be

Wait a few seconds and refresh. The panel loads after the page. If you are logged in to a caching or security plugin, clear its cache.

It says the widget isn’t switched on for this website

You are using a partner key that belongs to a different website address. Use the key on the website it was made for, or remove it from the settings: the panel works without one.

It says the panel is taking a short rest

The panel has reached its fair-use limit for the moment. It comes back by itself. This is rare for normal sites.

The homes are not very near

Few homes are listed within your distance, so the panel adds the nearest ones further afield, each with its distance. Increase the distance or choose a larger nearby town.

The panel looks too dark or too light

Set the colours to Light or Dark instead of matching the reader’s device.

Still stuck? Get in touch and we will help you set it up.

Optional: get a free partner key

The panel works without a key. A partner key ties the panel to your website, so no one else can copy it, and it lets us see which of your readers’ visits help. Get one from the publishers page. On WordPress, enter it once in Settings › UK Council Home Swaps. With the code option, the builder adds it to your code for you.

Who uses the homes to swap panel

  • Local newspapers and news sites that cover housing and want a useful extra for readers.
  • Community websites, parish and town council sites for neighbours who may want to move into or out of the area.
  • Housing associations and councils that want tenants to see real mutual exchange options beside their policy page. See are you a social landlord?
  • Local advice services and charities that help people with housing.

Readers can also look up their own landlord in the landlord directory, see council waiting lists, and read a guide to the area they would like to move to.

Questions and answers

Is the homes to swap panel really free?

Yes. There is nothing to pay and no contract, for the panel or for the UK Council Home Swaps WordPress plugin. We would be grateful if you kept the small "Powered by MutualHomeExchange.co.uk" link under the panel, and the Publisher Terms explain the few rules.

How long does it take to add the panel to my website?

About ten minutes. With the WordPress plugin you install it, type your town or postcode in the settings and add a block, widget or shortcode. On any other website you paste one line of code where you want the panel to appear.

Do I need to know how to code?

No. The WordPress plugin has a block, a widget and a shortcode builder that writes the shortcode for you. For other websites, the builder on the publishers page writes the one line of code, and you paste it into an HTML or embed block.

Which homes does the panel show?

Council and housing association homes that tenants have listed for a mutual exchange, nearest to the town or postcode you choose, each with a photo, the number of bedrooms, the type of home, the rent and the distance. Homes within your chosen distance come first. If there are only a few, the nearest ones further afield are added under a "Further afield" heading, so the panel is never empty.

Does the panel show private details or set cookies?

No. It shows only what is already public on each home's page: the photo, title, bedrooms, type, rent and the postcode district, never the street. The panel sets no cookies and tracks no one.

Will the panel slow my website down?

No. It loads after your page has appeared, only when it is near the screen, and it fits its space on phones and tablets. The list of homes is kept for a few minutes on our side, so it is quick for everyone.

Can I change the colours and the size?

Yes. Choose a narrow sidebar shape or a wide section shape, light, dark or automatic colours that follow the reader's device, and your own accent colour. You can also choose how far to look (1 to 50 miles) and how many homes to show (1 to 6).

Why can't I save my WordPress page after adding the shortcode?

That is your web host's firewall (often ModSecurity), not the plugin. It sometimes blocks a page save and shows a 403 Forbidden message. Ask your host to check the firewall log and allow the rule, or switch ModSecurity off for your domain while you save the page. A new page often saves fine.

What is a partner key and do I need one?

A partner key is optional and free. It ties your panel to your website so no one else can copy it, and it lets us count how many of your readers' visits help. The panel works without one.

Can a council or housing association add the panel to its own website?

Yes. Landlords can put the panel beside their mutual exchange page so tenants see real homes to swap near them while they are already looking. The social landlord page explains five ways to help tenants swap.

Ready to add it?

Build your panel, or get the plugin, and have it live in about ten minutes.

Build your panel Get the plugin Publisher Terms