Custom HTML lets you add your own content to the customer portal: a seasonal offer, a banner image, a button that links to a collection, or a note about shipping times. You paste HTML and CSS into a box in Appstle, and customers see it the next time they open the portal. You don't need to edit your theme.
Availability
Custom HTML is available on every plan. It shows in the customer portal on your online store. If your store uses Shopify's new customer accounts, check Where customers manage subscriptions in your Customer Portal settings: when it's set to Inside Shopify customer accounts, customers don't see your Custom HTML.
Before you start
Decide where the content goes. The top box shows it above the portal content, and the bottom box shows it below.
Have your HTML and CSS ready. Scripts and Liquid code can't be saved here: see What you can and can't add below.
If you want an image, upload it to your store first (Content → Files in Shopify admin) and copy its web address. The recommended image size is 1620 × 269 px.
Add content to your customer portal
In Shopify admin, open Appstle Subscriptions and click Customer Portal.
Click the Custom HTML tab. If you don't see it, click More views first.
Scroll to Customer Portal Top HTML for content above the portal, or Customer Portal Bottom HTML for content below it.
Click inside the code box and paste your HTML and CSS.
Click Save in the bar at the top of the page.
Open your customer portal (usually
/apps/subscriptionson your store), signed in as a customer, and reload the page to check the result.
The Customer Portal Top HTML box with a banner pasted in.
If the save is refused, a note under the box says what to remove. See If your HTML doesn't save below.
Start from an example
This is the banner shown in the screenshots. The outer box lines it up with the rest of the portal. Paste it into Customer Portal Top HTML, then change the text, colors and link:
<div style="width:100%; max-width:1280px; margin:16px auto; padding:0 16px; box-sizing:border-box;">
<div style="background:#f3ede4; border-radius:12px; padding:24px 28px; text-align:center;">
<h2 style="margin:0 0 8px; font-size:28px; line-height:1.2;">Thanks for being a subscriber</h2>
<p style="margin:0 0 16px; font-size:16px;">Add our new seasonal roast to your next order.</p>
<a href="/collections/all"
style="display:inline-block; background:#1a1a1a; color:#ffffff;
padding:10px 20px; border-radius:8px; text-decoration:none;">Shop all products</a>
</div>
</div>
The Add simple portal content card at the top of the tab has a Sample HTML and CSS template too. Click Copy code, paste it into a box, and change it to suit your store. Use ChatGPT opens ChatGPT with a ready-made request for a banner, and Use Gemini opens Gemini. Read what they write before you paste it, because the same checks apply.
The Add simple portal content card, with the sample template and the Copy code button.
What your customers see
Content in the top box shows above the greeting ("Hello" and the customer's name). Content in the bottom box shows at the end of the portal, below the subscription cards. Both stay in place on every page of the portal.
A banner in the top box, above the customer's greeting.
Your CSS decides how the content looks on a phone, so open the portal on a phone or a narrow window before you finish.
The same banner on a phone.
What you can and can't add
Custom HTML takes HTML and CSS. You can add:
Text, headings, lists, links and images. For a button, style a link to look like one, as in the example above.
Tables, video and audio.
Inline styles (
style="...") and<style>blocks.Links to pages in your store, such as
/collections/all, links tohttps://addresses, and email and phone links (mailto:andtel:).
Appstle doesn't save these:
Scripts (
<script>) and Liquid code ({{ }}or{% %}).Event attributes such as
onclick, and links that start withjavascript:.Forms and fields (
<form>,<input>) and embedded pages (<iframe>,<object>,<embed>).Whole-page tags such as
<html>,<head>and<body>.Other tags and attributes that aren't common HTML, such as
<link>,<meta>anddata-attributes.
If your HTML doesn't save
When your code has something Appstle doesn't accept, nothing is saved, and customers keep seeing the HTML you saved before in both boxes. A message at the top of the page says "Your custom HTML has code that only support can add.", and a note under the box says what to remove. If the note lists several items, remove each one. These are the notes you're most likely to see.
Note under the box | What to do |
Remove scripts (<script>) to save this HTML. | Delete the |
Remove Liquid code ({{ }} or {% %}) to save this HTML. | Replace the Liquid code with plain text. To add Liquid code, contact support. |
Remove event attributes such as onclick to save this HTML. | Delete the attribute. Use a link ( |
Remove the href address on <a> (use an https:// address) to save this HTML. | Change the link so it starts with |
Remove form fields (<form>) to save this HTML. | Delete the form and its fields. Use a button-style link instead. |
Remove embedded pages (<iframe>) to save this HTML. | Delete the embedded page. |
Remove the <link> element to save this HTML. | Delete the tag or attribute that the note names. Only common HTML tags and attributes can be saved. |
Things to know
Anyone who opens the portal page sees your content, even before they sign in. Don't put anything in it that only subscribers should see, such as a private discount code.
Your theme's fonts and heading sizes apply to your content. To change them, set
font-sizeandfont-familyin your CSS.To remove your content, clear the box and click Save.
If a box already has a script or other code that it no longer accepts, that code keeps working, and you can still edit and save the rest of the box. To change that code, or to add it back after you delete it, contact support.
Only Appstle support can add scripts or Liquid code. To ask, click contact support in the Add simple portal content card.
Custom HTML adds content. To change the look of the portal itself, use the Custom CSS tab on the same page.
FAQs
Why doesn't my content show in the customer portal?
It wasn't saved. Reload the Custom HTML tab. If your code isn't in the box, paste it again and click Save. If a note shows under the box, see If your HTML doesn't save.
Customers manage subscriptions inside Shopify customer accounts. Custom HTML shows only in the portal on your online store. Check Where customers manage subscriptions in your Customer Portal settings.
It's in the other box. The top box shows above the greeting and the bottom box shows below the subscription cards.
Your CSS hides it. Check for
display:noneor a color that matches the background.
Can I add a tracking script or a chat widget?
Not in these boxes, because scripts can't be saved here. Contact support, and our team can review the script and add it for you. Apps that you add to your theme, such as a chat widget, usually show on the portal page already, because the portal opens inside your theme.
Can I add an image?
Yes. Upload the image to Content → Files in Shopify admin, copy its address, and use it in an <img> tag or as a CSS background. The recommended size is 1620 × 269 px.
Can I show a different banner to different customers?
No. Everyone who opens the portal sees the same top and bottom content, in every language your store offers.




