Sub Account Branding

Forge offers the ability to customize a branded tracking page for each sub account. Each shipment and tracker generates a unique URL that can be customized to reflect specific branding elements, enhancing the customer experience under the platform’s brand.

Access the Sub Account Branding Page

1. Log in to the Forge Dashboard.
2. Select Branding from the left menu. 
3. In the Sub Account Branding section, locate the desired Sub Account.
4. Click the [ ⋮ ] menu on the right and select Manage Brand.
   

Customize the Tracking Page

Use the available fields on the Branding page to customize the experience. A preview window on the right side of the screen displays real-time changes.

1. Format Style: Select from two available layout options.
2. Company Name: Enter the name to display on the tracking page.
3. Company Logo Link: Provide a destination URL for the company logo. The URL must begin with https:// or http://.
4. Company Logo Upload: Upload a logo image to be displayed on the tracking page.
5. Highlight Color: Enter a hex code to define the color used for key elements such as buttons and status indicators.
6. Background Color: Enter a hex code to define the page background color.
7. Right Side Promotional Image: Upload an option vertically oriented image (recommended ratio of 1:3) for promotions or marketing.
   • • Image Upload: Upload a promotional image file.
     • Image URL: Provide a destination URL for the promotional image. The URL must begin with https:// or http://.
8. Reset Brand: Restore branding settings to default.
9. Save Brand: Save the configured branding settings.
10. To view a full preview, select Preview Tracking Page.
    
    
    

Image Requirements

Logo Image

• Maximum Size: 10MB
• Accepted Formats: SVG, PNG, or JPG

Promotional Image

• Maximum Size: 10MB
• Minimum Width: 460px, 920px recommended for high pixel-density devices.
• Recommended vertical orientation with a 1:3 aspect ratio.
• Recommended to highlight seasonal promotions, special offers, or marketing campaigns.

Configure Branding via API (Optional)

Sub account branding can also be configured through the EasyPost API.

Request

  curl -X PUT https://api.easypost.com/v2/users/user_.../brand \
    -u : \
    -d ‘brand[background_color]=#FFFFFF‘ \
    -d ‘brand[color]=#303F9F‘ \
    -d ‘brand[logo]=data:image/png;base64,iVBORw0K...‘ \
    -d ‘brand[logo_href]=https://www.easypost.com‘ \
    -d ‘brand[ad]=null‘ \
    -d ‘brand[ad_href]=null‘ \
    -d ‘brand[theme]=theme1‘

Response

{
  "color": "#303F9F‘",
  "logo": "https://brand.easypostpartnercontent.com/(…).png",
  "logo_href": "https://www.easypost.com",
  "name": "My Account Name",
  "ad": null,
  "ad_href": null,
  "object": "Brand",
  "user_id": "user_...",
  "background_color": “#FFFFFF”,
  "theme": "theme1"
}

Additional Resources

Brand - API Docs