> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook

> How to add Facebook to your system

<Snippet file="never-share.mdx" />

<Warning>
  **NOTE:** Please be advised that Instagram and Facebook can use the same app (no need to create two separate apps)
</Warning>

<Steps>
  <Step title="Create a new app">
    Select a business portfolio, then create a [new app in Facebook developers](https://developers.facebook.com/apps/creation/).

    Please be advised that for public applications, you will need to verify your business.

    <img src="https://mintcdn.com/postiz/NC1G4tduhaxm8LzE/images/providers/facebook/Business-Portfolio.png?fit=max&auto=format&n=NC1G4tduhaxm8LzE&q=85&s=0c8b3ff1674149ae9a9a312b614a4d4f" alt="Business Portfolio" width="1854" height="511" data-path="images/providers/facebook/Business-Portfolio.png" />

    <img src="https://mintcdn.com/postiz/NC1G4tduhaxm8LzE/images/providers/facebook/Create-an-app.png?fit=max&auto=format&n=NC1G4tduhaxm8LzE&q=85&s=ddddf127593b97f363d10b6cdffb954a" alt="Create app" width="1332" height="555" data-path="images/providers/facebook/Create-an-app.png" />
  </Step>

  <Step title="Select app type">
    Select "Other" and click next

    <img src="https://mintcdn.com/postiz/NC1G4tduhaxm8LzE/images/providers/facebook/Other-app-use-cases.png?fit=max&auto=format&n=NC1G4tduhaxm8LzE&q=85&s=b3019dc009d89b072f2c1115a980bbba" alt="Other app use cases" width="1074" height="996" data-path="images/providers/facebook/Other-app-use-cases.png" />
  </Step>

  <Step title="Select business">
    Then select business

    ![Business](https://github.com/user-attachments/assets/74bde861-5441-46bb-b5b8-c5229e980237)
  </Step>

  <Step title="Add details and create app">
    Add all your details and click Create App

    ![Create app details](https://github.com/user-attachments/assets/f0c03825-0f9b-4467-94a4-ab8cf6ed7e1d)
  </Step>

  <Step title="Set up Login with Facebook">
    ![Setup Login with Facebook](https://github.com/user-attachments/assets/08d3c1d1-d498-49d1-adac-aa6248e7c10c)

    Set up login for business
  </Step>

  <Step title="Configure redirect URI">
    Set up a redirect URI back to the application

    ![step 6](https://github.com/user-attachments/assets/8bf1774b-b6fe-4ac6-aea5-97d8c8bbf5da)

    <Snippet file="oauth2redirect.mdx" />

    **Your Facebook OAuth2 Redirect URI:**

    * Production: `https://your-postiz-domain.com/integrations/social/facebook`
    * Local development: `http://localhost:4200/integrations/social/facebook`
    * Docker: `http://localhost:5000/integrations/social/facebook`
  </Step>

  <Step title="Request advanced permissions">
    ![step 7](https://github.com/user-attachments/assets/a81aa2a3-de66-4099-906b-b78c641d1a23)

    Go to advanced permission and request access for the following scopes:

    * `pages_show_list`
    * `business_management`
    * `pages_manage_posts`
    * `pages_manage_engagement`
    * `pages_read_engagement`
    * `read_insights`

    <Note>
      If your Postiz install is for personal use only these advanced permissions are not required for Postiz to function.
    </Note>
  </Step>

  <Step title="Set app mode to Live">
    Change the App Mode from 'Development' to 'Live'. If you do not do this then posts made via the API will display for yourself but will not be visible for other users.
  </Step>

  <Step title="Copy your credentials">
    ![Keys](https://github.com/user-attachments/assets/ac11f87f-4951-47f8-8344-7fbc9de942e4)

    Go to basic permissions copy your App ID and App Secret and paste them in your `.env` file

    ```env theme={null}
    FACEBOOK_APP_ID="app id"
    FACEBOOK_APP_SECRET="app secret"
    ```

    Facebook should now be working!
  </Step>
</Steps>

## Troubleshooting

### Image is missing from the published post

Check the **App Mode** of your Facebook app. In **Development** mode, posts with media are only visible to app developers/testers — everyone else sees the post without the image. Switch the app to **Live** mode to make the image visible to all users.

### Facebook posts work for you but not for other users

Same root cause as above — the app is in Development mode. Only roles you've explicitly added (developers, testers, admins) can see content published via the API. Set the app to Live.