A guide to customizing and organizing your Substack website
Substack helps anyone set up a website and email newsletter so you can build your own media business, supported by subscribers. Part of the magic of Substack has always been how easy it is to start a publication—no tech knowledge is required. While maintaining that ease, we want to give you customization where it counts, with tools that help you match your brand and style to your writing.
In this guide, we’ll walk you through the tools that you have to add polish and personality to your website and to organize your posts, creating an easy-to-navigate experience for readers.
Before we get into the tools, let’s first review the key components of a Substack website and some examples of how other writers have designed their websites.
Overview
Substack website
Your Substack website has two key pages: the welcome page and the homepage. The welcome page is where a reader lands when they visit your publication for the first time. The homepage is where readers can explore your latest posts and you can organize your full archive.
Both pages have been carefully designed to let your writing shine and help you communicate your brand style.
Image dimension key
Logo: At least 256 x 256 pixels, with a transparent background
Wordmark: At least 1,344 x 256 pixels, with a maximum aspect ratio of 21:4
Cover photo: At least 600 x 600 pixels
Social/post preview image: We recommend at least 1,456 x 1,048 pixels, but 420 x 300 is the minimum. 14:10 is the aspect ratio for the preview images.
If these numbers feel overwhelming and you don’t know where to begin with website design, don’t worry. Uploading any image will help add some personality to your publication, and our system will crop it to make it look its best.
Get inspired
With varying design skills, interests, and resources, writers are finding a way to create an aesthetic that matches their writing.
The DIY approach
- uses Canva to create a library of assets she can pull from to add images to Unruly Figures. Her advice to writers: “I think the key is finding something that appeals to you personally and is also endlessly malleable. When I created the branding for Unruly Figures, I made files of dozens of imagery motifs, little sketch accents that I can pull in whenever I start a new section or feel like the look needs a bit of a refresh.”
- , who publishes Above the Fold, a Substack about dumplings and the people who make them, creates her own visual assets using Canva to give her publication a magazine-like feel.
Watch now: A tour of Canva from Leah Mennies
Using design constraints
- uses striking photos that his dad took in the 1980s when he was a photographer in rural northern Ohio to accompany each new post on Experimental History.
- uses color constraint, black and white in this case, to inform design choices for Zine. His advice to fellow writers is to ask themselves, “How do my graphics, font, colors, layout, and formatting help augment what I’m trying to convey to my audience?’”
Use great photos
- uses beautiful food photography from her kitchen to bring her posts to life on Cook with Lerato.
- uses a combination of personal and stock photos from Unsplash. You can add stock photos using Unsplash to any Substack post from image search in the editor.
Read more: How do I add free images or pictures to my Substack post?
Partner with an artist
- collaborates with artist Alexander Naughton to create a unique illustration for each post. Erik shared in an interview, “This creates an aesthetic for the entire newsletter, which in turn makes everything look more professional, which in turn builds the reader’s faith that you’re going to lead them somewhere interesting.”
- worked with a designer to create a logo and plug-and-play assets that they can use to showcase interviewees on the publication.
Tools
In this section we’ll review the following customization and organization tools:
Welcome page
Logo and wordmark
Social preview images
Site design
Layout
Color
Font
Navigation
Sections
Tags
Pages
Homepage links
Welcome page
Think of the welcome page as your book cover. The welcome page default includes a logo, one-line description, the author’s name, a statistic about the publication, a button to subscribe, and a short information-collection disclaimer. Writers have the option to customize it further with a cover photo, background color, and Recommendations blurbs. Visit the Basics section in your settings to update.
On this page, focus on the one-line description. A great one-liner clearly and concisely highlights what your publication is and what differentiates it from the other newsletters out there. For some writers, that’s their years of particular domain expertise; for others, it’s their unique voice and personality; and for others, it’s covering a niche that nobody else can.
Your one-line description should speak to your target audience and emphasize the value they will get when they subscribe. The goal should be for a reader to see your one-line description and think, “That’s for me!”
Examples:
- : “A newsletter for people who are pissed off about the climate crisis.”
- : “Research-based parenting tips and insights to make your life easier.”
- :“One ridiculously impressive complete-meal recipe delivered to your inbox every Sunday morning that dirties minimal dishes and requires under an hour of time.”
- : “A weekly advice column about building product, driving growth, and accelerating your career.”
You might make a stylistic choice to include your one-line description directly in your cover photo, like
of Popular Information. In this case, you can hide the one-line description text from your settings and make the cover photo the main focus.
Read more: How do I edit my welcome page?
Logo and wordmark
A logo is your brand symbol and helps readers visually identify your publication. A wordmark is a text-based logo. Combined, over time these visual cues help subscribers recognize your work in the world.
There are no hard rules for what makes an appealing logo; it’s a personal choice. Follow your intuition and play with design to find something that feels like it matches your personality and is distinct.
Canva, The Noun Project, Flaticon, Looka, Logology, and Adobe Express all offer free or low-cost options for creating a logo.
Update your logo and wordmark from the Basics section in Settings.
Social preview images
The social preview image doubles as the preview image on your publication site and the preview image of any link shared on social media or in text messages. The default is the first image in your post, but if you don’t have any images in your post or would like to select a different image, you can upload one from the post settings.
A good social preview image, like the title, should evoke curiosity and prompt the reader to click to read more.
A good social preview image, like the title, should evoke curiosity and prompt the reader to click to read more.
Site design
In this section, we’ll review how to update your layout, color, and fonts. You can update all of these elements from the Theme editor in Settings.
Layout
Our layouts were designed to be flexible and grow with you. You can choose more of a magazine look or a simple, sophisticated blog look.
There are three key layout components to choose from:
Hero: Your most important and newest post should stand out. Choose between feature, magazine, or newspaper mode to display your most recent or pinned posts.
Feature mode puts your single most recent or pinned post front and center. This is best when you want to draw visitors’ attention to one post above all else.
Magazine mode shows off five of your most recent and pinned posts. It is best for publications that are visual-forward.
Newspaper mode displays eight of your most recent posts, plus pinned posts. This shows the widest preview of posts.
Posts: Display your remaining posts in list or grid view.
List view offers a familiar reader experience that is easy to navigate.
Grid view suits highly visual publications with lots of images.
Top posts: Choose to feature top posts in a highlighted section. Posts are generated based on views, engagement, and recency. This gives visitors a flavor of your greatest hits and helps spotlight the best from your archive.
Update your homepage from the Theme editor on your Settings page.
Color
From the Theme editor, you can also choose a background and accent color. Your background color will be the default on your homepage and all posts on the web. The accent color is used for things like buttons, pull quotes, and hyperlinks if you choose.
You want interactive elements, like buttons, to be highly visible. Choose an accent color that creates high contrast, making them stand out and easy to read.
Font
Substack has intentionally added fonts to themes that are reader-friendly. Fonts can also be a stylistic choice. You have the choice between a handful of serif and sans serif fonts. Pick one that matches your personality.
Navigation
In this section, we’ll review sections, tags, and pages—the tools you have to organize your content.
Sections
As your publication expands to include more posts, topics, and contributors, Sections are a tool to create different mailing lists associated with distinct topics.
Each section will appear in a tab at the top of your publication’s homepage. Additionally, your subscribers can opt into or out of receiving emails for each section on their account page at yourdomain.substack.com/account.
Substack writers are using publication sections in a variety of creative ways.
Here are some examples to inspire you:
Burnt Toast: Podcaster and author Virginia Sole-Smith has a section for her podcast, essays, advice column, and behind the scenes of her latest book.
The Free Press: A publication with a high volume of posts uses a hidden section to send out roundups to subscribers. This allows the authors to send posts via email that do not show up on their publication website.
The Ankler: A multi-contributor publication covering the entertainment industry uses sections to separate the different beats covered by different writers.
The Charlotte Ledger: A local news publication has sections for transit news and obituaries.
Recommentunde: A comedy publication has sections for multiple podcasts.
Jatan’s Space: A science newsletter has sections for different space topics.
Read more: A guide to Substack Sections
Tags
Unlike Sections, Tags allows you to organize your work and make it navigable for readers without creating segmented email lists. Use tags to organize different post types, series, or beats.
Read more: How to tag a Substack post
Pages
Pages are standalone posts hidden from your homepage that do not populate in your archive. Writers can use the link generated with a page just like any other URL link. You might use pages for marketing, to create a table of contents, to display community guidelines, or to share events.
Here’s how writers have used Pages:
- created a page that links to all her best posts about her writing process, which she is frequently asked about.
- uses a page to track mistakes made in past issues all in one place.
Navigation bar and homepage links
Sections, tags, and pages can all be added to your navigation bar at the top of your site or to homepage links on the right rail.
To update the navigation bar, head to “Website” in “Settings.” Hide existing sections and defaults, plus add unique links.
Homepage links can also be updated in the “Website” section under “Settings.” Writers use this to display a list of all their published books, social media accounts, resources, and posts’ greatest hits.
Additionally, tags can be used as headings on the homepage to help further organize your post. In the theme settings select “Groups (sections or tags)” and add the sections or tags you’d like to display as headings.
On Substack, writers earn a living doing what they love. Getting started is easy. Set up your website and paid subscriptions in just a few minutes.
My branding has colors and fonts. I can set the color codes but the font selection is pretty limited. It would be great to support Google Fonts at least. No need for fancy custom fonts, but one should be able to use the name of a Google Font (which is distributed via CDN across the globe, without a serious performance hit).
Fonts allow giving a true character and feeling on top of the colors. I wish substack adds this feature.
Useful stuff for sure. But a plea to you Substack boss honchos: fix up your searchabilty. How come peeps can search on google for my exact post title, a phrase or even a Newsletter name, and get absolutely NO success. I can't even get a result using Substack's own search function to search for my own posts.
Substack really screwed the pooch on this one.
I know it might sound stupid, but one of the few reasons considering NOT to use substack is the wordmark being so small and that there is no option to make it bigger.
this is madness. I have struggled for two days
I'm battling with this issue six months into substack. It seems that everyone has the same problem
Why can I not fix this!! I have seen a few Substacks with nicely sized wordmarks? It must be possible?!
Right? My guess it's cause of mobile UI, so they had to make it fit in small screens, but I'm still baffled that I can't see it with a proper size when on laptop or desktop
Talk to me about wordmarks
You know what would be useful? A feature called Categories in which readers could consult a list of topics they might be interested in (like a pet care Substack might offer categories for Dogs, Cats, Little Critters, Animal Rescue, Pet Selection, etc.
I need to know how Elle Griffin is able to display two rows of "Most Recent Posts" right below her hero post. Also, how she gets 4 post columns in all her groups on the home page. If you look at my homepage all I get is an option for "Most popular" and they are super tiny. Also, in my groups they only run 3 columns across the page.
Did you ever get a response? I don't even see "hero" on as an option for me. And recent posts is always posted.
I missed your reply, sorry!
No I didn't get a response but have since figured out how to fully customize homepages. This original comment was a year ago and I don't think all the features were rolled out yet.
BTW, a hero post is just a regular post you write as a welcome of sorts. Then, you pin it to your homepage so it always sits at the top. Readers know to click on it and read it.
If you'd like to see examples, go look at my pubs and you'll notice a "welcome/start here" in the center. Those are what we call hero posts.
https://wildhoodwanted.substack.com/
https://unstackit.substack.com/
Man, figuring out all this stuff about email sections and when to let people unsubscribe is a real brain-twister. I keep worrying that if I mix things up too much, everyone will just bail on all the emails they get. It's like, how do you balance giving people options with not overwhelming them, you know? It's tricky trying to come up with a game plan for this feature. For more info visit https://archive.ph/.
More fonts and a bigger wordmark. Then Substack will be the perfect choice for everybody. It is really that simple
For the pages:
I added a page to my nav bar. I have my settings to move all archives to paywall after a certain time. Although this article states that a page doesn't go into the archive, my stand-a-lone page is going into the archive and then become unavailable to free viewers. Am I simply misunderstanding how the Page feature works, or am I doing something wrong setting it up?
“Pages are standalone posts hidden from your homepage that do not populate in your archive”
If they are hidden how do people see it?
What I can't find is how people set the font size and the page width? For example, the font size and page width of this post. I have minuscule fonts and a narrow column that is completely at odds with those of other writers. There is nothing in the font styles and layout of the site design settings. What am I doing wrong? Any suggestion?
I am trying to make it work, but the whole design concept is horrible.
How do I separate the "header 1" "header 2" etc from the "normal" text? I change one and it changes all of it. I can't get it to separate them.
Thank you for the helpful information. I want to be able to choose a list of my most important publications that should be displayed in an appropriately labelled section on my home page. This list is not chronological and is not easily ordered based on the number of likes, views, comments, etc. Is there a way of calling viewer attention to such a list, and creating a custom list like this on the home page? Thanks again.
Thanks so much for the great info! I have an issue, which is that I can't seem to change my social image. I've uploaded a new one, it shows up, saved it, etc. but when I get a Share link, the old image keeps appearing. It's maddening! What I'd really like to do is delete the old social image which Substack seems to have saved somewhere but I can't for the life of me see where after looking for hours. Any help would be much appreciated!
Maybe it's a new rollout going on, but it seems like new writers to the platform have larger margins on their homepage design? Either that or the image widths have changed instead. Is there a way to trigger this feature on mine? It's a lot neater and cuter
I personally found this to be extremely informative, although I haven't started designing my pages yet. I'm reading and getting a lay of the land first, and I'm glad I am. I've read through lots of the comments here, and they help me appreciate I might run into some glitches - which is a good thing. Now I'll know that it's not "just me" if I encounter a problem. I usually find that walking away and taking a break from a computer issue, will make it work out when you return (either that or giving it a swift kick). Thanks so much.
Is it possible to add a note at the bottom of the home page?
It'd be great if you could reorder sections.
I have successfully implemented this page, but I have a problem. Even if this first page is mine and managed by myself, it is not my main page. I wish to have a separate and personal page. So, I tried to start another page with a different email, description, and so on. But your system is confusing the two pages, as tas they were only one. What to do? May I have two separate pages or not?
It would be really nice if Substack's default themes included light/dark mode pairings, so that users who prefer Dark Mode can get that easily. AFAICT most of the Substacks I read regularly all are using default color profiles with white backgrounds, which I find really annoying.
Hi, I can´t open the "theme" page on settings. I want to change the theme (color and layouts of my post and profile) but i cant. Can you help me?
Here’s how writers have used Pages: Elle Griffin created *a page* that links to all her best posts about her writing process, which she is frequently asked about. [The page you link to gives a 404 PAGE NOT FOUND error]
I just wanted to know how I could change what other substacks I display on my page.
all is revealed ... i understand now
The structure of the text makes it organized and easy to digest. https://orinocowind.com
Excellent tutorial. We newbies thank you!
Thank you for this detailed article i have a question can we use the same strategy for the seo of custom based websites. To know my question in detail you may visit https://drive.google.com/file/d/1M6PMQrehmeuRU_KDd_PTKsTtVNNB3bYl/view
Is there a way to add some custom text to the homepage? I'd love to add an small about section
Is it possible to change the order of primary navigation so the home button is not the one farthest to the left?
This is a huge help. Trying to wrap my head around sections and when to give readers the option to unsubscribe. I suppose I have a fear that doing something different will just have someone unsubscribe from everything when they get too many emails. So, I'm having a hard time with strategy around this feature.
I have written an article, but I cant work out how to post it on my substack. It still says editing. I cant even work out who to ask, but Iam trying here.
When you begin typing your latest articles, they are saved in the Drafts section of your Posts tab in your Dashboard. You can change settings in the post via the Settings button in the lower right while editing.
Once you’re ready to publish/schedule, click Continue in the upper right and you’ll see some of the same options as for Settings. That is where you’ll finalize the details of your post so it will be published. If scheduled, it will show up in the Scheduled section of your Posts tab; if published, it will be in the Published tab.
Pro Tip: If you need to edit a scheduled post, DON’T click Continue or it will prompt you to create a new scheduled date. Instead, just click the back arrow once you see the words “Draft Saved” in the top-left of your post. It will stay in this Draft stage until the date arrives and the post is actually published. Hope this helps and wasn’t too confusing ;)
Hi. I don't see the wordmark option anywhere under basics..is it someplace new now? Thanks.
Will there be an option for background image?
The customisation tools on here are absolutely fantastic and really do help you to create a unique look and feel. I've only just scratched the surface of what you can do so far, but I'm hoping to explore more soon... :)
Thank you for the information!!!
How do i add the subscribe button at the top of my navigation bar?
HELP! When I edit the theme and try to add a new Group it won't let me set theme (save changes). How do I overcome this?
It should automatically be in the centre on your Welcome Page already. The centre is the best place for it, where it's clearly visible. New visitors will land there first and see it. If you also always make sure to include a Subscribe Button at the top and bottom in all the content you post, people will see it there, too. Good luck... :)