---
title: "Adding a Subscription on a page"
canonical: "https://nsw-gov-au-help-hub.refined.site/space/HHK/602538667/Adding%20a%20Subscription%20on%20a%20page"
format: markdown
---
The Subscription block provides a simple, consistent format for including an external link to mail list forms, for example Mailchimp, where the audience can subscribe to newsletters or updates.

---

## When to use Subscription

By design, the Subscription displays with a grey background. The heading, body content and button are centred.

### Do

- Use Subscriptions when you want to link to a subscription form for newsletters and other subscriber only content.
- Only use this component for linking to an external URL subscription form, for example, Mailchimp.
- The Subscription block can be used on standard, landing and agency landing page templates.
- The Subscription block should be placed toward the bottom of your page.
- Use a descriptive heading – recommended limit of 50 characters.
- The body content should be short, clear and easy to scan – recommended limit of 200 characters.
- The body content should use paragraph formatting and should describe what the audience is signing up for.
- The Subscription URL should be a valid link to the subscription form.
- The link text appears in the Subscription block as a button.
  - Use active language that reflects the action the user is taking by pressing the button.
  - Recommended character limit is up to 20 characters (around 2-3 words) for the button text.
  - Button text should be sentence case, not all capitals.
- Consider using a custom block if the same Subscription block needs to be added to numerous pages.
- Remove the Subscription block when the information is no longer current.

### Don't

- Don't use the Subscription block for other types of content like announcements or important messaging, use a callout instead.
- Don't add other links to the body content as this may confuse the audience about what action to take.
- Don't use multiple subscriptions on the same page as this may confuse the audience about what primary action you want them to take.
- Don't add the Subscription block to the top or middle of your page. In general, the block should be placed at the bottom.
- Don't forget to remove the Subscription block if it was used for a campaign that has an end date.

---

## Adding a Subscription on a page

### Landing page

You can add a Subscription on a landing page by selecting **Subscription** from the list of [content blocks](https://nsw-gov-au-help-hub.refined.site/space/HHK/603750486/Available+components+for+Landing+pages).

### Standard page

You can add a Subscription on a standard page by selecting **Add Subscription** from the drop-down list of [blocks](https://nsw-gov-au-help-hub.refined.site/space/HHK/603717746/Available+components+for+Standard+pages).

### Configuring the Subscription block

- Give your Subscription block a descriptive **Heading**. Recommended limit of 50 characters.
- Select the heading Type:
  - H2
    - The option – Excluded from in-page navigation – displays when you select the H2.
  - H3
  - H4
  - H5
- Add **Content** (WYSIWYG) to the block. Recommended limit of 200 characters.
- Add the **URL** that links to the subscription form or page. This must be an external URL subscription form. For example, Mailchimp.
- Add **Link text** that will appear as a button. Recommended character limit is up to 20 characters (around 2-3 words) for the button text.

> ℹ️ ### See this live on [http://nsw.gov.au](http://nsw.gov.au) 
> ℹ️ 
> ℹ️ Visit [Subscriptions](https://www.nsw.gov.au/onecx-program/content-guidance/cms-components-guide/subscriptions) to see how this works on a live page.
> ℹ️ 
> ℹ️ You can also see live example of how the component has been applied by the [NSW Education Standards Authority](https://www.nsw.gov.au/education-and-training/nesa).