This is the official documentation for Choice, a blog, multi-column grid Tumblr theme by Stash Themes. Visual moodboard Tumblr theme for all types of content. Below you’ll find how to install it, what every option in the customize panel does, how to set it up for phones, and fixes for the most common problems. Best for: blogs and writing-led sites; grid-based moodboards and archives.
Theme page & preview · Choice on the Tumblr theme garden · Current version 2
1. Install Choice
There are two ways to put Choice on your blog. Both take about five minutes and need no coding.
Option A – one click from Tumblr
- Open Choice on Tumblr and click Install theme.
- Pick the blog you want to use it on. Tumblr opens the customize screen with the theme applied as a preview.
- Click Save, then Exit.
Option B – paste the code (downloaded or purchased copy)
- Download the .txt file from your order email or My Account → Downloads. Open it, click inside, press Ctrl/Cmd + A then Ctrl/Cmd + C.
- On a computer go to tumblr.com/customize/your-blog-name and click Edit HTML. Select all the old code, delete it and paste.
- Click Update Preview, then Save.
Stuck? See the full install guide with screenshots or fixes if the theme doesn’t show.
2. Choice features
- Beautiful animations on photo hovers and click.
- Full support for all modern browsers and devices.
- Customize background, logo, navigation, title, text, accent and sidebar colours to give a unique feel.
- Custom logo upload.
- Infinite scroll for quick scrolling through posts.
- Modal post for quick viewing of full image.
- Header banner & background customisation.
- Sidebar with social widgets, description and avatar.
- Social links on sidebar.
- Custom links to any website.
- The font size and font family are customizable. Google & Adobe font support
- Show/hide post tags.
- Show/hide post caption.
- Show/hide post meta.
- Show/hide post share.
- Show/hide photo overlay.
- Supports all post types.
- Google Analytics implementation
3. Theme options explained
Below is the option-by-option breakdown for Choice. Open tumblr.com/customize/your-blog-name, change a setting, click Update Preview, then Save.
Documentation of all the theme options compatible with the Black Coffee Tumblr Theme. You can access these via your Customize page to change the appearance and functionality of your blog.
Appearance Options
Title – this is where you set the Title of your blog, which is displayed in the header (logo) and in the title of the page in your browser for SEO purposes.
Description – this is for some basic information about your blog. It is displayed underneath the logo on the home page, above the posts.
Avatar – this is the image for your avatar, which appears all across Tumblr and as the favicon on your browser.
Avatar shape – square or circle
Show avatar – toggle to turn the avatar off or not on the front-end
Show title – choose whether to show your blog title (logo).
Show description – choose whether to show your blog description.
Image Options
Background – you can upload a background image
Logo – you can upload a Logo image, which will replace the Title in the header.
Sidebar Logo – you can upload a logo image for the sidebar
Banner Background – you can upload a background image for the optional banner
Mobile Banner Background – you can upload a background image for the optional banner to display on mobile
Color Options
Background – this sets the background colour of the whole website
Text – this sets the main text color for your blog and posts.
Logo – this sets the main logo color
Header Text – this sets the main text color for the header on the left
Sidebar Toggle – colour for the sidebar toggle
Sidebar Background – background colour for the sidebar which appears when the hamburger toggle is clicked
Sidebar Text – change the text colour for the fullscreen sidebar
Banner Background – this sets the background color for the optional Banner
Banner Text – this sets the text color for the optional Banner
Banner Button Background – this sets the background color for the optional Banners buttons
Banner Button Text – this sets the text color for the optional Banners buttons
Dropdown Options
Description Width – narrow or fullscreen
Photoset Post Type – the options allow you to choose how multiple photos in one post is displayed
- Carousel – photos are displayed in a carousel with arrows to navigate between each photo
- Normal – photos are displayed exactly as they are posted with the layout the same, you can edit this by editing the post.
Modal Photo Size – customize how photos opened in the modal are displayed
- Full – photos are displayed fullscreen with no gap
- Fit – photos are set to fit the window size with a slight border around them
- Wrap – photos are displayed in a small wrapAnd the available options are:
Font – choose from some pre-defined fonts
Logo Font Weight – choose the font weight for logo text
Header Text – uppercase, lowercase or normal
Sidebar Text – uppercase, lowercase or normal
Banner Video Volume – allow for banner video volume to be on by default (some browsers block this setting)
Banner Video Autoplay – choose if banner video autoplays by default or not
Toggle Options
Full Background – stretch background image to 100% of the window size
Repeat Background Image – repeat the uploaded background image
Navigation – display the navigation on the header
Sidebar – shows the sidebar toggle on mobile
Sidebar Logo – displays a logo on the sidebar
Search – shows the search input in the menu
Modal Post – opens posts clicked on the homepage in a special modal
Show Photo Overlay – displays caption and meta on hover for photo posts
Show Media Only – displays just the media for posts
Show Post Reblogs – show the name of reblog source on posts
Show Post Meta – Hide the post meta including share, reblog, like buttons
Show Post Notes – Show the post note count
Show Post date – show the date post was posted
Show post Share – Show post share dropdown
Show Post Tags – Show post tags underneath post
Home Link – show a “Home” link on the menu
Random Link
Archive Link
Rss Link
Banner – Toggle the fullscreen banner on/off
Banner Video Options – if using a banner video source show the buttons or not
Banner Overlay – display a black overlay over the banner background
Mobile Hide Banner – Hide banner on mobile
Banner Only no Posts – Set website as a landing page with just the banner
Text Options
Default Homepage Tag – Select a tag to redirect the website homepage to.
Font Size – Text font size default: 12px
Header Font Size – Text font size default: 12px
Logo Size – Text logo size default: 24px
Mobile Logo Size – Text logo size default: 18px
Sidebar Font Size: default 12px
Sidebar Logo Size – Text logo size default: 20px
Google Analytics ID: Link your website to Google Analaytics GA4
Font Embed Code – Add Custom HTML code to embed custom font
Body Font Family – Change the text font based on the embedded font
Body Font Weight – Change the text font weight
Logo Font Family – Change the logo text font based on the embedded font
Logo Font Weight – Change the logo font weight
Titles Font Family – Change the post titles font based on the embedded font
Titles Font Weight – Change the post titles font weight
Sidebar Footer Text – Add custom footer text on the sidebar
Sidebar Text Widget – Adds a paragraph of text on the sidebar
Sidebar Custom HTML – Add custom html onto the sidebar
Banner
Banner Youtube Video ID – Video ID of YouTube video to add video to banner
Banner Youtube Playlist ID – Playlist ID of YouTube playlist to add video to banner
Banner Vimeo Video ID – Video ID of Vimeo video to add video to banner
Banner Text – add text to the banner
Banner Text Size – change banner text font size
Banner Mobile Text Size – change banner mobile text font size
Banner Text Width – Width of the container of the text on the banner
Banner Button URL’s/Text – Text label and link for banner buttons.
Social Media
Link to your social media/email address
Each link should have https:// before
Make posts bigger
You can make a post double in size by adding the tag x2 on the post edit screen. This is applicable to both desktop and mobile.
4. Choice on phones and tablets
Choice is fully responsive. Turn off Use default mobile theme (Advanced options), set Mobile Posts Columns to 1 or 2, upload a Mobile Banner Background if you use the banner, and check the Mobile Menu toggle. View your blog in your phone’s browser (not the Tumblr app) to see the result.
5. Remove the Stash branding
Choice costs £12. Add the Full License at checkout (+£10) to remove the Stash credit, or buy it later for £19. After purchase you receive a short snippet to paste into Advanced options → Add Custom CSS. How the Full License works.
6. Troubleshooting
- Theme not showing / looks the same as before – make sure Enable custom theme is on, you clicked Save, and you’re viewing the blog in a browser, not the Tumblr app. All 8 fixes.
- Photos have scrollbars or gaps – apply the NPF photo fix or reinstall the latest version.
- Links lead to an error page – every URL must start with
https://. - Font didn’t change – fill in every font field after adding an embed code. Guide.
- Something broke after an edit – restore a previous version.
7. Frequently asked questions
How do I update Choice to the latest version?
Reinstall it from the Tumblr theme garden (Option A above) or download the current file from My Account and paste it in. Your colours, images and options are kept.
Can I use Choice on more than one blog?
Each licence covers one blog. For several blogs the theme bundle is the best value.
Can I change the layout myself?
Most layout choices are in the customize panel. For bigger changes, small tweaks are possible with Custom CSS, or ask us about theme customisation.
I need help.
Email support@stashfamily.com with your blog address and a screenshot, or book the installation service.
