Image Sizing
Stay organized with collections
Save and categorize content based on your preferences.
The profile picture and cover photos are returned by the People API as URLs.
You can append the following URL parameters to an image URL to get the image size that you want.
|
Syntax:
|
url=param1-param2...
|
|
Example:
|
https://lh4.googleusercontent.com/JDjSmaNIR-Q4l6d97ig=s100-c
|
| Parameter |
Name |
Description |
sn |
size |
Sets the longer of height or width to n pixels |
wn |
width |
Sets width of image to n pixels |
hn |
height |
Sets height of image to n pixels |
c |
square crop |
Sets height and width of crop to the same value |
p |
smart crop |
|
- 400 pixels in longest side
- Parameter:
=s400
- Example:
https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig=s400
- 400 pixels wide
- Parameter:
=w400
- Example:
https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig=w400
- 100 pixels high and cropped
- Parameter:
=h100-c
- Example:
https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig=h100-c
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe People API returns profile picture and cover photos as URLs that can be modified to control image size and cropping.\u003c/p\u003e\n"],["\u003cp\u003eYou can append parameters like \u003ccode\u003es\u003c/code\u003e for size, \u003ccode\u003ew\u003c/code\u003e for width, \u003ccode\u003eh\u003c/code\u003e for height, \u003ccode\u003ec\u003c/code\u003e for square crop, and \u003ccode\u003ep\u003c/code\u003e for smart crop to the image URL.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003es\u003c/code\u003e\u003cem\u003en\u003c/em\u003e sets the longer dimension to \u003cem\u003en\u003c/em\u003e pixels, while \u003ccode\u003ew\u003c/code\u003e\u003cem\u003en\u003c/em\u003e and \u003ccode\u003eh\u003c/code\u003e\u003cem\u003en\u003c/em\u003e set specific width and height, respectively.\u003c/p\u003e\n"],["\u003cp\u003eAdding \u003ccode\u003ec\u003c/code\u003e creates a square crop, ensuring both height and width are equal.\u003c/p\u003e\n"]]],["Image URLs from the People API can be modified by appending parameters. The syntax is `url=param1-param2...`. Key parameters include: `s` to set the longer side to a pixel value, `w` for width, `h` for height, `c` for square cropping, and `p` for smart cropping. For example, `=s400` sets the longest side to 400 pixels, `=w400` sets width to 400, and `=h100-c` sets the height to 100 and crops it to a square.\n"],null,["# Image Sizing\n\nThe profile picture and cover photos are returned by the People API as URLs.\nYou can append the following URL parameters to an image URL to get the image size that you want.\n\n|----------|----------------------------------------------------------------|\n| Syntax: | *url* `=`*param1-param2...* |\n| Example: | `https://lh4.googleusercontent.com/JDjSmaNIR-Q4l6d97ig=s100-c` |\n\n| Parameter | Name | Description |\n|-----------|-------------|--------------------------------------------------|\n| `s`*n* | size | Sets the longer of height or width to *n* pixels |\n| `w`*n* | width | Sets width of image to *n* pixels |\n| `h`*n* | height | Sets height of image to *n* pixels |\n| `c` | square crop | Sets height and width of crop to the same value |\n| `p` | smart crop | |\n\n400 pixels in longest side\n: Parameter: `=s400`\n: Example: `https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig`**=s400**\n:\n\n400 pixels wide\n: Parameter: `=w400`\n: Example: `https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig`**=w400**\n:\n\n100 pixels high and cropped\n: Parameter: `=h100-c`\n: Example: `https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig`**=h100-c**\n:"]]